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Introduction 


This package contains the third beta release of ResEdit 1.2 and a beta 
ResEdit Reference. 


New Features 


Editors for the ‘iti’, ‘it!1', "INTL', and 'KCHR' resources have been added, 
which should ease the creation and editing of international resources. The 
templates for the ‘itl0’, 'itl1*, and 'HEXA resources have been removed, 
because these are now supported by editors. 


All of the the bit editors - "CURS, ICN#, ICON’, 'PAT#, "PAT", and 
'SICN' - have been updated to work in the same fashion: 

« Shift-click drags a selection rectangle. 

٠ Once a selection has been made, it can be moved by shift-clicking and 
dragging. 

٠ Cut, copy, paste, and clear work on the selected bits or the entire bit 
area if nothing is selected. | 

٠ The delete key is the same as selecting clear from the edit menu. 


The 'DITL' editor has been enhanced in the following ways: 

٠ The arrow keys now will nudge a field one pixel at a time. 

« Font and Size menus have been added, though the settings are not 
saved. 

٠ Revert has been implemented in the dialog item editor. 


Templates for the 'actb', ‘cctb’, ‘clut’, 'dctb', ‘fctb’, ‘pitt’, 'ppat', and ۵ 
resources have been added. 
A preferences dialog has been added to the File menu which allows you 


to disable the alert displayed when a write protected disk is inserted and the 
alert displayed when the System file or ResEdit is opened. 


Licensing 
It you want to distribute ResEdit with your products, you must first obtain a 
license from: | 


Software Licensing 

Apple Computer, Inc. 

20525 Mariani Avenue, MS: 28-B 
Cupertino, CA 95014 
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Bug Reporting 


If you encounter bugs in ResEdit 1.2B3 or the ResEdit Reference, or 
have suggestions for features to improve ResEdit or the ResEdit Reference, 
please send them to the ResEdit product manager at his AppleLink address 
(MATTSON1) or via surface mail at the following address: 


Jordan Mattson 

ResEdit Product Manger 

Apple Computer, inc. 

10500 North DeAnza Bivd, MS: 27-5 
Cupertino, CA 95014 
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This chapter introduces ResEdit™, a stand-alone application for editing resources. 


ResEdit is an interactive, graphically based application for manipulating the various resources in a 
Macintosh® file. (Some Macintosh files don't have any resources, but all applications and most of 
the System Folder files do.) If you are used to other computers, you will rapidly discover that 
resources are handled very differently on the Macintosh computer. They are kept distinct from data 
in a special part of the file (the resource fork) and are separated from each other in small packages 
so that individual resources can be examined and edited easily. 


There are many different types of resources, and you can create your own with ResEdit if you dont 
find the type you need. It lets you create and edit all standard resource types except 'NFNT and 
'snd ', and copy and paste all resource types (including 'NENT and ‘snd "). ResEdit actually includes 
a number of different resource editors: There is a general resource editor for editing any resource in 
hex and ASCII format, and there are several individual resource editors for specific resource types. 
Many resource templates are predefined. You can also create your own resource editors or 
templates to use with ResEdit Thus, for example, you could build a template that would permit you 
to do some editing of 'snd ' resources. It is not particularly useful to build a template for 'snd ' 
resources; nor is attempting to edit 'CODE' resources with the general resource editor — there are 
better ways to accomplish these ends! 





Uses 
ResEdit is especially useful for creating and changing graphic resources such as dialog boxes and 
icons. For example, you can use ResEdit to put together a quick prototype of a user interface and 
try out different formats and presentations of resources. Anyone can quickly learn to use ResEdit for 
translating resources into languages other than English without having to recompile programs. You 
can use ResEdit to modify a program's resources at any stage in the process of program 
development. 


an 
Extensibility 

A key feature of ResEdit is its extensibility. Because it can't anticipate the formats of all the different 
types of resources that you may use, ResEdit is designed so that you can teach it to recognize and 


parse new resource types. 
There are two ways that you can extend ResEdit to handle new types: 


C You can create templates for your own resource types. ResEdit lets you edit most resource 
types by filling in the fields of a dialog box—this is the way you edit 'BNDL' and 'FREF 
resources, for example. The layout of these dialog boxes is determined by a template in 
ResEdit's resource file, and you can add templates to edit new resource types. Resource 
templates are described later in this manual. 


C You can program your own special-purpose resource picker or editor (or both), and then add it 
to ResEdit. The resource picker is the code that displays all the resources of one type in the 
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Figure 1-1 
The resource development cycle 
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resource type window. The editor is the code that displays and allows you to edit a particular a 
resource. These pieces of code are separate from the main code of ResEdit. A set of Pascal or C | 
routines, called ResEd, is available for this purpose—see Chapter 5 for information. 


The resource development cycle 


ResEdit is often used with Macintosh Programmer's Workshop (MPW) and other program 
development systems. Once you have created or modified a resource with ResEdit, you can use 
MPW's Resource Decompiler, DeRez, to convert the resource to a textual representation that can be 
processed by the Resource Compiler, Rez. You can then add comments to this text file or otherwise 
modify it with the MPW Shell editor or another text editor. (Rez and DeRez are fully described in 
the MPW Reference.) Figure 1-1 shows how ResEdit fits into the development process with MPW. 
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Chapter 2 
Getting Started 
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Consider, within the context of ResEdit, that there are three kinds of resources on the Macintosh. 
Some resources are accessed with individual pickers and edited with individual editors that are part 
of ResEdit These resources are described in some detail in Chapter 3. 


Within the first category are several pictorial resource types CICON,, 'ICN#’, 'PAT ', and so on). All 
of the editors for these pictorial resources behave very much like FatBits, but only one (the 'FONT 
Editor) offers several tools; for the rest, the cursor acts like the pencil tool in MacPaint. In the 
ICON’, 'ICN#!, and 'CURS' editors, holding down the Shift key allows you to use the Marquee tool, 
but only to move part of the picture. In this (1.2b1) release you cannot yet cut, copy, or paste with 
the Marquee tool 


Other resources are edited as templates. Some information on templates is included in this version 
of the ResEdit Reference, but there wasn't time to include a full description. 


Still other resources are edited with thegeneral editor (the HEXA Editor), unless you wnte your own 
templates or editors for them. Again, there is not much discussion of this third category in this 
version of the ResEdit Reference. 


DAA A ——————— ——— 
Resource ID numbers 

Within a given resource type, resource ID numbers must be unique. Resources can, in general, have 
any ID number between -32768 and +32767, but you should be aware of the following restrictions, 
which apply to most resources: 


0 ID numbers from -32768 to -16385 are reserved. Do not use them! 

0 ID numbers from -16384 to -1 are used for system resources that are 
owned by other system resources. 

0 ID numbers from 0 to 127 are used for system resources. 

0 ID numbers from 128 to 32767 are available to you for your uses. 


Some system resources own others. The “owner” contains code that reads the “owned” resource 
into memory. For example, desk accessories CDRVR' resources) can have their own patterns, 
strings, and so on. Please see Chapter 5 of Inside Macintosh, Volume I, for more information. 


For 'FONT resources, the ID number for a particular resource is the family ID number muluplied by 
128, to which is then added the point size of the font. Thus, font 268 is New York (family ID 2) 12 
point The family ID is the ID number of the associated 'FOND' resource. Note that for 'FOND' 
fonts, the family ID cannot exceed 255. This relationship is quite different for 'NFNT fonts; there, 
the ID number of the 'NFNT resource is arbitrary, so there is no particular connection between the 
‘FOND’ ID number (the family ID) and the ID numbers of the corresponding 'NFNT resources. 
(This decoupling facilitates resolution of conflicting ID numbers, which is performed automatically 
by the Font/DA Mover.) Fonts of type 'NFNT' can be moved and deleted, but not modified, with 
ResEdit. (Version 3.8 or later of the Font /DA Mover also moves and deletes type 'NFNT'.) ۲ 
fonts can contain and display more than one bit per pixel, and can be assigned absolute colors with 
2 corresponding 'fctb' resource, which is a ColorTabie record. (Font ColorTable records are 
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If you are new to ResEdit, you will want to proceed with some caution, as ResEdit is remarkably 
powerful and can easily damage or destroy your files. It is a good idea to edit spare copies of files 
rather than originals, and to avoid editing the contents of the System Folder on the current startup 
volume. (Under MultiFinder™, you cannot use ResEdit to open the current Finder™ or desktop file.) 


If you are using ResEdit in conjunction with MPW, please read the relevant material in the MPW 


Reference. 


Installing ResEdit — 


If you will be using ResEdit within the MPW Shell, copy ResEdit into the Applications folder or 


elsewhere in the search path defined by the {Commands} variable. If you will not, the location of 


ResEdit is not important 


Invoking ResEdit — 


From the Finder, you can select and open the ResEdit icon. From the MPW Shell, you can start 


ResEdit by entering either of these commands: 


ResEdit 
ResEdit filel file2 . 


The latter command causes ResEdit to open the named files automatically. 


ResEdit displays a window that lists the files and folders for each disk volume currendy mounted 
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Transfer... Allows you to transfer to an application other than the 
application that launched ResEdit 


Quit Quits ResEdit and returns to the Finder (or the MPW Shell, 
HyperCard, or whatever program launched ResEdit). 


a nn mm nn 
Warning 


You can edit any file shown in the window, including the System file and ResEdit itself 
(though there are some restrictions under MultlFinder). It’s dangerous. though. 
to edit a file that's currently In use. Edit a copy of the flle instead. 
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ResEdit recognizes a new disk when it's inserted, and handles multiple disk drives. Note that you 
can also use ResEdit to delete files: 


o To delete a file, select the file and choose Clear from the Edit menu. 


o To copy a resource file, you must select all of its resources and copy them. Then 
paste them into a new file. (File attributes are not automatically copied by this 
operation—you must set them via the Get Info command.) ResEdit cannot copy 
a data fork. 


Working within a file 


When you open a file, a window displays a list of all the resource types in that file (Figure 2-3). 
While this window is the active window, you can create new resources, COPY Or delete existing 
resources, and paste resources from other files. 


$ Note: The resources are displayed by a resource picker. The general resource 
picker displays the resources by type, name, and ID number, there are also 
special resource pickers for some resource types. (See Chapter 3 for a detailed 
discussion of some of these resources.) 
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Figure 2-3 
A ResEdit fle window 
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Clear Removes all resources of the resource type selected, without 
placing them in the ResEdit scrap. 
Duplicate Not usable here. 


Working within a resource type 


Opening a resource type produces a window that lists each resource of that type in the file 
(Figure 2-4). This list will take different forms, depending on the particular resource picker; if you 
hold down the Option key during the open, the general resource picker is invoked. 





Figure 2-4 
A resource type window (with custom picker) 


When a resource type window is the active window, the File menu commands have the following 


effects: 

New Creates a new resource and opens its editor. 

Open Opens the appropriate editor for the resource you selected. 
Open As Lets you open a resource using a template you specify. 


Open genera] Opens the general (HEXA) resource editor. 


Close Closes the resource type window. 
Save Saves the changes you have made to the file. 
Revert Changes all resources of the open type back to what they were 


before you opened the resource type window, 
unless you bave cut or cleared a resource, 
(It will restore all but the ones that were cut or cleared.) 


Get Info Displays resource information and allows you to change it 
Figure 2-5 is an example. 
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Working with files 


To list the resource types in a file, select and open the filename from the list. (You can select a 
filename by clicking on it or by typing one or more characters of the filename.) To select more than 
one item, hold down the Command key while clicking the individual items, or click an item at the 
beginning of the range you want to select, hold down the Shift key, and click the item at the end of 
the range. (You can, of course, continue to select or deselect individual items with the Command 


key.) 


When a directory window is the active window, the File menu commands act as follows: 


Creates a new file. 


Opens the selected file or folder. (Choosing this command has 
the same effect as double-clicking the filename or pressing the 
Retum key or the Enter key.) 


Closes the volume window. (Using this command has the same 
effect as clicking the close box.) If the volume is a 3.5-inch 
disk, the disk is ejected. 


Not usable at this level. 


Displays file or folder information and allows you to change it 
Figure 2-2 is an example of the File Info window. 
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Figure 2-2 
A File Info window 
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When a file window is the active window, the File menu commands have the following effects: 
New Creates a new resource in the open file. 
Open Opens a window displaying all resources of the resource type 


selected. (Select the resource type by clicking on it or by typing 
its first character, if that's unique, or first two characters.) 


€ Note: If you hold down the Option key while opening a resource type, the 
resource window will open with the general resource picker. 


Open general Opens the general resource picker. 


Close Closes the file window and asks if you want to save the 
changes you have made. 
Save Saves the changes you have made. 


9 Note: If you've made changes, you should not reboot before closing. Under 
ordinary circumstances, pressing the programmer's switch is the only way to 
reboot from inside ResEdit, so most ResEdit users are unlikely to have any 


problems related to this issue. 
Revert Changes the resource file back to the version that was last 
saved to disk. 
Waming 


if you have cut or cleared an individual resource, this level is the only level af which 
choosing Revert will accurately restore the file! 


Transfer... Quits ResEdit, allowing you to transfer control to another 
application. 
Quit Quits ResEdit. If you have made any changes, ResEdit asks 


whether you want to save them. 


When a file window is the active window, the Edit menu commands have the following effects: 


Cut Removes all resources of the resource types selected, placing 
them in the ResEdit scrap. 

Copy Copies all resources of the resource types selected into the 
ResEdit scrap (not the Clipboard). 

Paste Copies the resources from the ResEdit scrap into the file 
window's resource type list. 
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Some of ResEdit’s resource editors are discussed in this chapter. The use of the editors not 
discussed here should be apparent when you run them. 


To open an editor for a particular resource, either double-click the resource or select it and choose 
Open from the File menu. One or more auxiliary menus may appear, depending on the type of 
resource you're editing. Some editors, such as the 'DITL' editor, allow you to open additional editors 
for the elements within the resource. All the editors use File and Edit menus similar to those 
described above, but operate on individual resources or individual elements of a resource, and 
hence vary in their appearance and function as explained in this chapter. 


If you hold down the Option key while opening a resource, the general data editor (HEXA Editor) 
is invoked. This editor allows you to edit the resource as hexadecimal or ASCII data. 


$9 Note: The general data editor can now edit resources larger than 255K bytes; if 
a resource is between 256 and 511K, each click in the up or down scroll 
arrows scroll 2 lines; if between 512 and 767K, each click scrolls 3 lines, and 
so on. (The scroll bars keep track of position with an integer.) 


If you hold down the Option and Command keys while opening a resource, a list of templates is 
displayed. You may then select the template that is appropriate for the resource you are opening. 
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Quits ResEdit, allowing you to transfer control to another 
application. 


Quits ResEdit. If you have made any changes, ResEdit asks 
whether you want to save them. 









Type: Size: 256 


Name: lb; E NETS 

Owner = 
WOEF 

sub ID: pecus 2 


Attridutes: 
O System Heap (Locked C) 0 
O Purgeebie O Protected 






Figure 2-5 
An ICN#' Get Info window 


Transfer... 


Quil 


When a resource type window is the active window, the Edit menu commands have the following 


Not usable. 


Removes the resources that are selected, placing them in the 
ResEdit scrap. 


Copies all the resources that are selected into the ResEdit scrap. 


Copies the resources from the ResEdit scrap into the resource 
type window. 


Removes the resources that are selected, without placing them 
in the ResEdit scrap. 


Creates a duplicate of the selected resources and assignis a 
unique resource ID number to each new resource. 


effects: 
Undo 


Cut 


Copy 


Paste 


Clear 


Duplicate 


When you choose Open As, a list of templates is displayed, and you can pick the one you want to 


use. 
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ALRT and 'DLOG' resources display dialog boxes on the screen. Editing them is much like editing 
"WIND! resources, except that if you double-click on the picture of the dialog box after opening the 
resource, the corresponding 'DITL' resource is automatically opened. (See the next section.) When 
you display an individual 'ALRT or 'DLOG' resource, a corresponding menu appears. It has only 
one item, Display as Text In the text view, the resource ID of the associated 'DITL' can be changed. 


Figure 3-2 shows an 'ALRT' open for editing. You can see the ALRT menu header in the menu bar. 


6 File Edit ۲ 
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Figure 3-2 
Editing on 'ALRT resource 


ResEdit Reference Beta Version 18 


€ ) 


20 


Allows you to change the order of items in the item list 
Bring to Front causes the selected item to become the last 
(highest numbered) item in the list The actual number of the 
item is shown by the 'DITU Item Editor. (Since it is drawn 
last, it becomes the front item.) 


Like Bring to Front, except that it makes the selected item 
the first item in the list—that is, item number 1. (Since it is 
drawn first, it becomes the back item.) 


Allows you to specify a new number for the selected item. 
Allows you to select an item by specifying its number. 


Aligns the item on an invisible 8 pixel by 8-pixel grid. If you 
change the item location while Align to Grid is on, the 
location will be adjusted such that the upper-left corner lies 
on the nearest grid point above and to the left of the 
location you gave it. If you change the size, it will be made a 
multiple of 8 pixels in both dimensions. 


Restores the enclosing rectangle to the rectangle size stored 
in the underlying resource. Note that this command works 
on ‘ICON’, ‘PICT, and 'CNTL' items only; the other items 
have no underlying resources. 
Adjusts the window size so that all items in the item list are 
visible in the window. 

Changes the 'DITL' back to the size specified in the parent 
'DLOG' or 'ALRT.. The algorithm used to find the parent is as 
follosvs: 


1. Check for a 'DLOG' with the same ID, 
2. Check for an 'ALRT with the same ID; 
3. Check for any 'DLOG'; 

4. Check for any 'ALRT'; 

S. Use Full Window. 
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Bring to Front 


Send to Back 


Set Item Number 
Select Item Number 
Align to Grid 


Use RSRC Rectangle 


Use Full Window 


Use Owner Window 
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TCON resources. 


For 'ICON resources, the editor displays one panel in the window (Figure 3-5). The left side of this 
panel shows an enlargement of the icon, and is an editing area. The right side of the panel shows 
the icon at full scale. Edit as if you were in FatBits. 


é Fite Edit 


Encellent Birds 
HyperCard 
IT TUTO HyperCard 1.1 
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Figure 3-5 
Editing an ICON’ resource 
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'WIND' resources 


A "WIND' resource defines a window on the screen. When you open a "WIND! resource, ResEdit 


displays a small picture ofthe screen with the window shown in its usual size and location, to scale. 


17 


You can move the window by clicking anywhere except in the lower-right corner, and size it by 
using its lower-right comer. Moving or sizing a window changes the default values when the 
window is actually displayed. To change the name of the window, select Display as Text from the 
WIND menu. (When the window appears on the screen in normal operation, the name may be 
displayed. If it is displayed, it shows up as a title, in the tide bar.) 


Firgure 3-1 shows a ‘WIND’ resource open for editing. 


€ file Edit WIND 
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Figure 3-1 
Editing a WIND’ resource 
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An ICN# editing example 
If you have written an application, and you want to install a new icon for it when you already have 
an old one in the Finder’s desktop file, follow these steps: 


Open the file called DeskTop. You cannot do this under MultiFinder! If you are 
using MultiFinder, restart your Macintosh while holding down the Command 
key, to disable MultiFinder temporarily. 


Open type 'BNDL' and find the bundle that belongs to your application. (This 
is the one that has your owner name in it.) Look through the bundle and mark 
down the types CICN#, 'FREF) and resource IDs of the resources bundled 
together by the bundle. 


Go back to the DeskTop window and remove these resources along with your 
'BNDL' and signature resource (the resource whose type is your application's 
signature). 


Close the DeskTop window, save changes, and quit ResEdit. Your new icon 
will be installed if you have the proper 'BNDL', 'FREF', and 'ICN# resource 
numberings. 


Note To see how 'BNDL', 'FREF', and 'ICN*' resources are interrelated, use 
ResEdit to look at those resources in an existing application. 


1. 


Alternatively, you can rebuild the DeskTop file by holding down the Option and Command keys 
when entering the Finder. (This method is faster and easier, but destroys Finder “Get Info" 
comments. On a non-HFS volume, it also destroys folder names.) 
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'DITL resources 
Because they are linked, the 'DITL' (dialog item list) resource for a given item is usually given the 
same ID number as the parent 'DLOG' ۰ 


For 'DITL' resources, the editor displays an image of the item list as your program would display it 
in a dialog or alert box. When you select an itern, a size box appears in the lower-right comer of its 
enclosing rectangle so that you can change the size of the rectangle. You can move an item by 
dragging it with the mouse. 


If you open an item within the dialog box, the editor associated with the item is invoked; for an 
ICON’, for example, the icon editor is invoked. If you hold down the Option key while opening 2 
'CNTL', ICON’, or 'PICT, the general data editor is invoked. If you hold down the Command key 
while opening a 'CNTL', ICON’, or 'PICT', the DITL Item Editor (the same editor used for buttons, 
static text, and so on) is invoked. 


Figure 3-3 shows the 'DITL' corresponding to the 'ALRT from Figure 3-2. The ALRT menu has been 
replaced by the DITL menu. 
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Figure 3-3 
Editing a 'DITL' resource 


The DITL menu contains the following commands: 
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'FONT resources 


The 'FOND' resource is not well described in this preliminary manual. It is inumately related to the 
'FONT resource. Kerning tables and other important information about a font are stored in the 
‘FOND’ that corresponds to the 'FONT. 


For 'FONT' resources, the editing window is divided into four panels: a character editing panel, a 
sample text panel, a character selection panel, and a typical set of graphics tools. These panels are 
shown in Figure 3-8. 
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Beauty is momentary in 
the mind - / The fitful 
tracing of a portal / But 
in the flesh it is 
immortal. 
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Figure 3-8 
Editing a FONT resource 


The character editing panel, on the left side of the window, shows an enlargement of the selected 
character. You can edit it, as with FatBits, by clicking bits on and off. Drag the black triangles at the 
bottom of the character editing panel to set the left and right bounds (that is, the character width). 
Two of the three triangles at the left side of the pane! control the ascent and descent The third 
shows the location of the baseline, which is fixed and is displayed only for reference. Below the 
panel are the ASCII value of the character and the character's offset, width, and location, all in 
decimal notation. 
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'"CURS' resources 


For 'CURS' resources, the editor displays three images of the cursor (Figure 3-4). You can 
manipulate all three images with the mouse. 





Edifing a 'CURS' resource 


In Figure 3-4, the left image shows how the bulldozer cursor will appear. The middle image is the 
mask for the cursor, which affects how the cursor appears on various backgrounds. The right image 


shows a gray picture of the cursor with a single point in black. This point is the cursor's “hot spot” 
(its active region). 


The Cursor menu contains the following commands: 


Try Cursor Lets you try out the cursor by having it become the cursor in use. 
Restore Arrow Restores the standard arrow cursor. 


Data -> Mask Makes a filled-in copy of the cursor in the mask editing area. 
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'PAT resources 


The 'PAT' resource editor is shown in Figure 3-9. It displays a single panel, with the pattern shown 
around a central editing area. This area shows the pattem, enlarged. The outer area shows the 
pattern at full scale, as you edit the central area as if you were using FatBits. 


é File Edit 


No It Doesn’t 


O Applet ink. 
6 
a 





System Folder 









Altsys4 


DDO2DPODDUDDD 





Figure 3-9 
Editing a PAT ' resource 
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'ICN#' resources 


For 'ICN* resources, the editor displays two panels in the window (Figure 3-6). The upper panel is 
used to edit the icon. It contains an enlargement of the icon on the left, and an enlargement of the 
icon's mask on the right The lower panel shows, from left to right, how the icon will look 
unselected, selected, and open on both a white and a gray background. It also shows how the icon 
will appear unselected, selected, and open in the Finder's small icon view. 


In recent versions of the Finder, 'ICN resources are displayed on the screen as follows: First the 
mask is used to blank an area of the screen. Then an OR is performed, using the icon as data, in 

the same screen area. (When a highlighted icon is displayed, the foreground and background colors 
are swapped before the OR operation is performed on the data.) If the mask is not the same shape 
as the outline of the icon, the results will in general be unaesthetic unless the background is black. 


The Cursor menu contains the following commands: 


Data -> Mask Makes a filled-in copy of the icon in the mask 
editing area. 
Display using old method Lets you display the icon in the lower panel, 


using the method that was used by pre-6.0 
finders. If the mask is just a filled-in copy of the 
icon, you probably won't see a difference 
between the old and new displays. 
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Figure 3-6 
editing an 'ICN#' resource 
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Hints and kinks 


(In the final version of this book, there will be a “ResEdit Hints and Kinks” chapter. For the 
moment, however, this section is not long enough to take an entire chapter.) 


‘PICT resource from bitmap. The bitmap image, possibly a screen snapshot or some 
artwork, is in the data fork of a MacPaint® file (for example), and is not directly accessible 
to ResEdit. Select and copy (or cut) the part you want. The image is stored in the Clipboard 
as a 'PICT', which you can paste with ResEdit. For longer-lasting storage, paste it into the 
Scrapbook, where it is also stored as a ۰ 


Pig mode. If you hold down the Command, Option, and Shift keys while selecting 
About ResEdit from the Apple menu, you can toggle a special stress testing mode. In this 
mode, ResEdit performs a compact-memory operation and a purge-memory operation each 
time it receives an event from the queue, excepting null events. This is, clearly, something 
most people will never have any use for. 


A Suggestion. It is probably a good idea to choose Get Info for ResEdit and increase 
Application Memory Size to at least 512K. (If you are editing very large resources, even 
512K is not sufficient.) 


O 
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'SICN' resources 


'SICN' (small icon) resources are edited much as other pictorial resources are, but 
unlike 'ICON' or 'ICN# resources, they can occur in groups. A typical display is 
shown in Figure 3-7. The upper panel is enlarged, and shows the icon currendy 
being edited. The lower panel shows three icons at full scale. The one shown in 
the upper panel is enclosed in a box in the lower panel. To get to a different icon, 
click on its picture in the lower panel. If the one you want to edit is not currently 
visible, click on either the righthand or lefthand picture, as appropriate, until it 


appears. 


A new icon can be added before (to the left of) the currenuy selected icon by 
selecting the New command from the File menu. Commands on the Edit menu can 
be used to cut copy, caste, clear, or duplicate icons. 
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Figure 3-7 
Editing a 'SICN' resource 
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Chapter 4 


Making Your Own ResEdit 
Templates 
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Warning 
Changing the ascent or descent of a character changes the ascent or descent for 
the entire font. 





The sample text panel, at the upper right, displays a sample of text in the font currently being 
edited. (You can change this text by clicking in the text panel and using normal Macintosh ediung 
techniques.) 


The character selection panel is below the text panel. You can select a character to edit by typing it 
(using the Shift and Option keys if necessary), or by clicking on it in the row of three characters 
shown. To move upward through the ASCII range, click on the right character in the row; click on 
the left character to move downward The character you select is boxed in the center of the row. 

(To scroll quickly, click on the right or left character, hold the mouse buton down, and move the 
pointer outside the selection panel, to the right or left.) 


The graphic tools panel, directly below the character selection panel, offers several familiar graphics- 
manipulation tools, including the pencil, eraser, circles, and rectangles. 


Any changes you make in the character editing panel are reflected in the text panel and the 
character selection panel. 


You can also change the name of 2 font The font name is stored in two places: as the name of the 
'FOND' resource of that font family, and as the name of the size 0 ‘FONT resource. To change the 
font name, select the individual 'FOND' resource with the name you wish to change, and choose 
Get Info from the File menu. To maintain consistency, you should also change the name of the 0 
point 'FONT resource; this resource does not show up in the normal display of all fonts in a file. To 
display it, hold down the Option key while you open the 'FONT type from the file window. You 
will see a generic list of fonts. Select the font with the name you wish to change, and choose Get 
Info. 
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The generic way of editing a resource is to fill in the fields of a dialog box—for example, this is the 
way you edit 'FREF', 'BNDL', and 'STR* resources. The layout of these dialog boxes is set by a 
template in ResEdit's resource file. The template specifies the format of the resource and also 
specifies what labels should be put beside the editText items in the dialog box that's used for 

editing the resource. You can find these templates by opening the ResEdit file and then opening the 
type window for 'TMPL' resources. For example, if you open the template for "WIND! resources (the 
"TMPL' with name WIND), you'll see the template shown in Figure 4-1. 
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Figure 4-1 
WIND‘ template data 


The window template consists of the following elements: 
1. A RECT (4 words) specifying the boundary of the window. 


2. A word that is the procID for the window. (DWRD tells ResEdit to display the 
word in decimal as opposed to hex.) 


3. A Boolean indicating whether or not the window is visible. (BOOL is 2 bytes 
in the resource but is displayed as a radio button in the dialog window used 
for editing.) 


4. Another Boolean indicating whether or not the window has a close box. 


5. Along word that is the reference value (refCon) for the window. (DLNG 
indicates that it should be displayed in the editor as a decimal number.) 


6. A Pascal string (PSTR), the tile of the window. 
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'PAT#' resources 


The 'PAT# editor is much like the 'SICN' editor, and is shown in Figure 3-10. Instead of displaying a 
single enlarged picture of the pattern being edited, it shows two. The one on the left is for editing, 
and is in FatBits; the one on the right shows the resulting pattem at full scale. 
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Figure 3-0 
Editing a PATH" resource 
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ResEdit handles all standard resource types (except as noted in Chapter 1). However, you may want 
to create and edit your own types of resources. You can write extensions to ResEdit in Pascal or C, 
substituting your own program for parts of its code. This chapter tells you how to do it in Pascal. 
The final version of this book will contain further information on C language extensions to ResEdit 
Some calls have been added to ResEd; there was not sufficient time to document them for this 
release. They will be included in the final version of this book. 
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Using ResEd 


The program you write must be a Pascal unit or C header file and library. Its interface with ResEdit, 
if it is written in Pascal, is established by the MPW unit ResEd, contained in the file ResEd.p. Your 
unit must begin with a USES declaration for this unit. 


The assembly-language code that “opens up” ResEdit and activates your program is contained in the 
file ResEd68k.a. It must be linked with your Pascal or C module. When you open a resource of your 
type, ResEdit will jump to this code. 


To install your new editor after it is compiled, place it in ResEdit’s file (using ResEdit itself) with the 
type 'RSSC' and a unique ID number. (You can use ResEdit to check the ResEdit file to see which 
ID numbers are already taken.) Your editor’s name in the ResEdit file must be of the form @ABCD, 
where ABCD is the name you have assigned to the new type it edits. Install your picker (also of 
type 'RSSC') with the name ABCD (without the commercial “at” sign.). 


nn 
Pickers and editors 
When ResEdit uses your program, it looks for two general capabilites: a picker and an editor. 


Pickers and editors are separate from the main code of ResEdit and hence may be supplied by user- 
written software. 


The picker is the part that displays all the resources of your type in the resource type window. It is 
given the resource type and should display all resources of that type in the current resource file, 
using a suitable display format. If the picker is given an open call and there's a suitable editor, it 
should launch the editor. 


The editor is the code that displays and lets you edit a particular resource. The editor is given a 
handle to the resource object and should open an edit window (or windows) for you. 


Note that pickers and editors can be opened from anywhere. For instance, a dialog editor might 
open an icon picker so that you could choose an appropriate icon. While using the icon picker, you 
could open the icon editor if you wanted (o create a new icon. 
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The resource map entry record accesses the contents of a resource map directly. It is used by the 
routines Get 1MapEnt ry and Get 1IMapEnt ry, described later in this chapter. 


The parent record 

Each picker or editor has its own object handle. This handle must start with 2 handle to its parent's 
object, followed by the name distinguishing the father. This name will be part of the son’s window 
title. The next field should be the window of the object, which may be used by the son to get back 
to the father, through the refCon field in the windowRec record. The rest of the handle can be of 
any format 


ParentPtr = ^ParentRec; 
ParentHandle = ^ParentPtr; 
ParentRec = RECORD 

father: ParentHandle; 

name: Str64; 

wind: WindowPeek; 


rebuild: boolean {flag set by son to indicate} 
{that world has changed so} 
{father should rebuild list} 
END; {ParentRac} 
The picker record 


{Any type is OK here.} 


{back ptr to dad} 
{picker window} 


{resource ID of picker} 
{type for picker} 
{resfile number} 

{size of a null resource} 
{number of instances} 
{list of instances} 

(list draw procedure} 
{scroll bar} 


The standard picker record has this structure: 


PickPtr = ^PickRec; 

PickHandle = ^PickPtr; 

PickRec = RECORD 
father: ParentHandle; 
fName: Str$4; 
wind: WindowPtr; 
rebuild: boolean; 
pickID: integer; 
rType: ResType; 
rNum: integer: 
rSize: longint; 
nInsts: integer; 
instances: ListHandle; 
drawProc: Ptr; 
scroll: ControlHandle 

END; (PickRec] 


Launcher routines 


The GiveEBirth procedure is used to launch your editor. 


The GiveEBirth procedure 


PROCEDURE GiveEBirth (b: Handle; pick: PickHandle); 


GiveEBirth launches an editor for a specific resource. The parameter 5 is the handle to that 
resource as returned by Get Resource; pick is the handle to your own picker record. 
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You can look through the other templates and compare them with the structure of those resources 
to get 2 feel for how you might define your own resource template. (These templates are equivalent 


to the resource type declarations contained in the (RIncludes) directory-—refer also to the DeRez 


Decimal byte, word, long word 
Hex byte, word, long word 


Word , long align 


Byte, word, long fill 


Hex dump of remaining bytes in resource_ 

Pascal string (length byte followed by the characters) 
Long string (length long followed by the characters) 
Same as LSTR, but a word rather than a long word 


Pascal string padded to even or odd length (needed for 


DITL resources) 


C string (characters followed by a null) 
Even-padded C string, or odd-padded C string (padded 


with nulls) 


Boolean 


Binary bit 


Type name (4 characters, like OSType and ResType) 


A single character 
An 8-byte rectangle 


A 3-digit hex number (where nnn > $900); displays 


nnn bytes in hex format 


command in the MPW Reference, and the appropriate chapters of Inside Macintosh.) 


These are the types you have to choose from for your editable data fields: 


DBYT, DWRD, DLNG 
HBYT, HWRD, HLNG 
AWRD, ALNG 

FBYT, FWRD, FLNG 


HEXD 

PSTR 

LSTR 

WSTR 

ESTR, OSTR 


ECST, OCST 


BOOL 
BBIT 
TNAM 
CHAR 
RECT 


Hnnn 


ResEdit does the appropriate type checking for you when you put the editing dialog window away. 
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The template mechanism is flexible enough to describe a repeating sequence of 
items within a resource, as in 'STR&', 'DITL', and 'MENU' resources. You can also 
have repeating sequences within repeating sequences, as in 'BNDL' resources. To 
terminate a repeating sequence, put the appropriate code in the template as 


follows. 
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The WindList function 


FUNCTION WindList (w: WindowPtr; nácross: integer; pt: Point; drawProc: integer): 
ListHandle; 


WindList creates a new empty list and returns a handle to that list For more information on lists 
and a description of the WindList parameters, see the List Manager chapter in /nside Macintosh, 
Volume IV. 


The WindOrigin procedure 
PROCEDURE WindOrigin (uw: WindowPtr) ; 


WindOrigin moves the window pointed to by wto a position down and to the right of the 
current front window. 


The WindSetup function 
FUNCTION WindSetup (width, height: integer: f, s: Str255): WindowPtr; 


WindSetup creates and automatically positions a new window with the given width and height 
and displays a title formed by ConcatStr (f, 5). It returns a pointer to the window. 


Resource utilities 


The five ResEd routines listed in Table 5-1 act the same as the Macintosh Resource Manager 
routines, but operate only on the currently selected resource file. For further information about 
these routines and their parameters, see Inside Macintosb, Volume IV, Chapter 5. Six additional 
resource utility routines available in ResEd are described below. 
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Miscellaneous utilities 


The ResEd routines described in this section perform miscellaneous tasks in a ResEdit extension 
program. They are listed in alphabetical order. 


The AbleMenu procedure 
PROCEDURE AbleMenu (menu: integer; enable: Longint) : 


AbleMenu enables and disables menu items. The parameter menu is a menu ID; enable is a mask. 
AbleMenu differs from the Resource Manager routines EnableItemand Disableltem in that it 
acts on the entire menu. (Values for the mask have changed recently, and are available in ResEd.) 


The AddNewRes function 
FUNCTION AddNewRes (bNew: Handle; 5 ResType; idNew: integer; s: Str255): boolean; 


AddNewRes has the same parameters and performs the same action as the Macintosh procedure 
AddResource, with the addition that it returns t rue if it is successful and false otherwise. For 
information about AddResource, see Inside Macintosh, Volume I, Chapter 5. 


The AppRes procedure 
PROCEDURE AppRes; 


AppRes performs the action of UseResFile on ResEdit itself. It is useful if you need to get a 
resource from the resource editor, such as an ICON or DITL, for your editor to use. 


The BubbleUp procedure 
PROCEDURE BubbleUp (2: Handle); 


BubbleUp sets up the correct heap zone, and then performs the Memory Manager rouune 
MoveHHi. For information about MoveHHi, see Inside Macintosh, Volume II, Chapter 1. 


The BuildType function 
FUNCTION BuildType (ft: ResType; l: ListHandle): integer; 


Given a list that has been initialized with no rows, BuildType builds a list of all resources of type 
t from the current resource file. (See the WindList routine described above.) If 
SetResLoad(true) has been called, all the resources will be loaded in also. BuildType returns 
a count of the number of instances currently in the list. 


The ClearHand procedure 
PROCEDURE ClearHand(b: Handle) ; 


ClearHand clears the resource referenced by the handle ۸ to ail zeros. 


ResEdit Reference Beta Version 42 


..— -- ~ . ساس بود س‎ - s Tonne 


nl 


2 


FileNewType puts up a dialog box containing a list of the types of resources that can be edited. 
The list is referenced by types. FileNewType then returns true if the user selects a type, false 
if Cancel is clicked. The selected type is returned in 5. 


The FixHand procedure 
PROCEDURE FixHand(s: longint; b: Handle); 


FixHand makes sure the object to which 6 is a handle is s bytes long. If it’s longer, FixHand 
shrinks it; if it’s shorter, FixHand expands it and fills the extension with zeros. 


The HandleCheck function 
FUNCTION HandleCheck (b: Handle; msgiD: integer): boolean; 


HandleCheck checks to see if the handle 4 is nil or empty. If it is either, HandleCheck returns 
false; otherwise, it returns true. The parameter msgID is the ID from STR# resource ID 129. If 
this function fails, it calls ErrorCheck. 


The MetaKeys procedure 
PROCEDURE MetaKeys (VAR cmd, sbift, opt: boolean); 


MetaKeys accesses the modifier flags for the last event, returning their values in cma, shift, and 
opt. For further information about modifier flags, see Inside Macintosh, Volume I, Chapter 8. 


The NewRes function 
FUNCTION NewRes (s: longint; f: ResType; l: ListHandle; VAR m: integer): Handle; 


Given a size 5, NewRes allocates a new handle, clears it, adds it to the current resource file as a 
resource of type £, adds it to the list $ and returns a handle to the new resource. The parameter 7 is 
the item number in the list ۸ If this function fails, it returns a nil handle. 


The PickEvent procedure 
PROCEDURE PickEvent (VAR evt: Event Record; pick: PickHandle); 


PickEvent handles an event contained in evt for a standard picker referenced by pick. Call 
PickEvent from your picker's event procedure. 


The PickinfoUp procedure 
PROCEDURE PickInfoUp(oldID, newiD: integer; pick: PickHandle); 


PickInfoUp handles an information update (identified by o/dID and newlD) for a standard picker 
referenced by pick. Call PickInfoUp from your picker's DoInfoUpdate procedure. If the ID has 
not changed, oldID and newID will, of course, be identical. 
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A sample ResEdit extension program is given in the file "ResXXXXEd p". In this sample, XXXX 
represents your resource type. 


The sample program is called by means of the Edit Birth routine when a resource of type XXXX 

must be edited This routine is passed two handles: a handle to the resource to be edited (the same 

handle that would be received by using a Get Resource call) and a handle back to the picker that 

has launched this editor. The Edit Birth routine and other necessary routines will be described in 
more detail in the full release of this reference. 


The program then creates a window and sets up any data structures needed to operate. Because it 
may be loaded in and out of memory during any given session and because it doesn't have access 
to global variables, it creates a handle to a data structure to hold all data that needs to be preserved 
between calls. It stores the handle in the edit data structure rXXXXrec. Note that the handle to the 
edit data structure is stored in the window’s refCon parameter. ResEdit uses this to idenufy which 
subprogram is to receive 2 given call. 


ResEdit will determine which editor should receive which events, so you need to do very litde 
event decoding in your editor. During an update event, the BeginUpdate and EndUpdate calls 
are done by ResEdit, not by the extension program. 


Here are two things to remember when writing a ResEdit extension: 


9 Always know which resource you are requesting and where it will come from. 
Many resource files may be open at any given time. Whenever a resource is 
needed, make sure which resource file you are accessing by using 
UseResFile or similar operations. 

O Your editor may be called with an empty handle in order to create an entirely 
new instance of the type you edit. 


The ResEd interface 


The ResEd unit contains data structures, procedures, and functions that you can access from your 
extension program. They are described in the remainder of this chapter. 


Data structures 


The ResEd unit declares the data structures described in this section, which provide communication 
between extension programs and ResEdit. 


The resource map entry 


ResMapEntry = RECORD 
rID: integer; 
rNameOff: integer; 
rlLoen: longint; 
rHndl: Handle 
END; {ResMapEntry} 
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The ScrapEmpty procedure 
PROCEDURE ScrapEmpty; 


ScrapEmpty empties the ResEdit scrap. Call it before doing a Cut or Copy operation. 


The ScrapPaste procedure 
PROCEDURE ScrapPaste (resFile: integer); 


ScrapPaste pastes the resources from the ResEdit scrap to the file identified by the ID number 
resFile. 


The ٩۵۱۶۲۱11 procedure 
PROCEDURE SetETitle(b: Handle; VAR sm Str255); 


Given a handle bto a resource, SetETitle concalenales the resource’s ID with its name and 
places the result into sir. 


The SetResChanged procedure 
PROCEDURE SatResChanged (5: Handle); 


SetResChanged marks the resource b as changed so that it will be updated when your program 
terminates. 


The Showinfo procedure 
PROCEDURE ShowInfo(b: Handle; dad: ParentHandle); 


ShowInfo puts up a Getlnfo window for the resource referenced by h that belongs to the father 
obiec referenced by dad. 
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There are four other routines, Call PBirth and CallEBirth, CallEvent, andCallMenu, that 
are included in the ResEd unit, the use of which is not recommended unless your editor invokes 
another editor (as, for example, the DLOG editor invokes the DITL editor). 


information-passing routines 


The four routines described in this section are used to pass information between ResEdit and your 
program. CallEvent and CallMenu are rarely used. 


The CallinfoUpdate procedure 
PROCEDURE CallInfoUpdate(oldID, newiD: integer; object: Longint; id: integer); 


CallInfoUpdate tells the picker that launched your editor that an ID or name has been changed, 
added, or deleted, making it necessary to rebuild the picker list. The parameter object identifies the 
resource and editor, id identifies the resource ID of the object. 


The PassMenu procedure 


PROCEDURE PassMenu (menu, iem: integer; father: ParentHandie); 


PassMenu passes menu selections on to any son pickers or editors that you have launched with 
ShowInfo. Here is an example of its use: 


PassMenu(file, close, myOb}); {Tell ali subsidiary windows to close.) 


Window utilities 


The five ResEdit window-handling routines described in this sectíon are available to your program. 


The WindAlloc function 


FUNCTION WindAlloc: WindowPtr; 


WindAlloc returns a pointer to a window record to be used by your editor. Using this routine 
instead of allocating your own window pointer can help reduce heap fragmentation. WindAlloc 
has no parameters. 


The WindFree procedure 


PROCEDURE WindFree(w: WindowPtr); 


WindFree releases the window pointer allocated by WindAlloc. Use this when you terminate 
your editor and you are finished with its window, but only if you used WindowAlloc to create the 
window. 
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Resource Monager calls 

nn‏ ا دس ا سس اد ا ا 
Res£d routine ۱ Corresponding Macintosh roufine‏ 
امتح تسس یات سس 
FUNCTION  CountlType CountiTypes‏ 

PROCEDURE GetlIndxType GetlindType 

FUNCTION CountlRes CountlResources 
FUNCTION GetliIndex GetlindResource 
FUNCTION GetiRes GetlResource 

The CurreniRes function 


FUNCTION CurrentRes: integer; 


CurrentRes returns the ID number of the currently selected resource file. 


The Get1MapEntry procedure 
PROCEDURE GetiMapEntry (VAR beEniry: ResMapEntry; $: ResType; id: integer); 


GetlMapEntry accesses the resource map for a resource of type tand ID number id, placing the 
result in theEntry. For a description of resource maps, see "Format of a Resource File” in Inside 
Macintosh, Volume 1, Chapter 5. 


The GetliMapeEntry procedure 
PROCEDURE GetllMapEntry (VAR theEniry: ResMapEntry; f: Rest ype; index: integer): 


Get 1IMapEnt ry acts like Get 1MapEnt ry, described above, except that it refers to ils resource 
by index instead of ID number. 


The GetResLoad function 
FUNCTION GetResLoad: boolean; 


يه 


GetResLoad returns the current value set by the Macintosh procedure SetResLoad. 


The RevertResource function 


FUNCTION RevertResource (5: Handle): boolean; 


RevertResource restores a resource being edited to the state it was in before editing started. The 
parameter bis a handle to the resource. RevertResource returns a value of false if the 
resource was newly added by ResEdit (and, therefore, no longer exists after the reversion), true 
otherwise. 
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The ConcatStr procedure 
PROCEDURE ConcatStr(VAR srl: St 2255: str2: Str255) ; 


ConcatStr concatenates str2to str1, leaving the result in 51 





Waming 


This routine does not check for aggregate string length in excess of 255 characters. Please be 
carefull 





The CopyRes function 
FUNCTION CopyRes (VAR b: Handle; makelD: boolean; refNum: integer): Handle; 


Given a handle b to a resource, CopyRes makes a copy of the resource to the resource file 
specified by refNum. Note that the handle is changed, so you can't keep track of your resource by 
saving its handle before using CopyRes. If makelDis true, a unique ID will be assigned to the 
copy; otherwise, it retains the ID of the original. CopyRes returns a handle to the new copy (in the 
new file). 


The DolistEvt procedure 
PROCEDURE DoListEvt (e: EventRecord; i: ListHandle) ; 


Given an event e and a list /, DobistEvt does the standard dispatch to the List Manager. (See 
Inside Macintosh, Volume IV.) The port must be set to the window that owns the event 
DoListEvt also enables the File menu and draws controls in the window. 


The DupPick function 
FUNCTION DupPick(b: Handle; c: cell; pick: PickHandle): Handle; 


DupPick duplicates a resource referenced by 5, adds it to the picker list referenced by pick, and 
performs an InvalRect action on thePort for the new cell c. It also makes the new cell the 
selection. 


The ErrorCheck function 
FUNCTION ErrorCheck (err, msg/D: integer): boolean; 


Given a result code err and a message ID number msgID, ErrorCheck brings up an error dialog 
box if err is nonzero. If msgID is negative, the box displays a fatal error message retrieved from 
STR# resource ID 128; otherwise, it displays a message retrieved from STR# resource ID 129. 
ErrorCheck returns t rue if successful, false otherwise. When creating new strings for use by 
ErrorCheck, be sure to add them to the end of the existing list in the STR# resource. 


The FileNewType function 
FUNCTION FileNewType (types: ListHandle; VAR s: Str255): boolean; 
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About the Resource Editor 
In the February 1985 Software Supplement we have included a pre-release of the - 
Resource Editor with an icon that looks like a Jack-in-the-box. Because it is 
pre-release and may blow up, before editing any resource files on a disk we 
recommend backing up the disk. 


Basic functionality - The resource editor allows you to create and edit resources and 
resource files. It comes up displaying a disk window for each mounted volume. The 
applicable commands and what they do at this level are: 


DISK WINDOW - displays all resource files on the disk 
Eile 
New - creates a new resource file, prompting you for its name and opens a file window 
for that file. 
Open (double-click) - opens a file window for the file selected. 
Close (clicking close box) - ejects the disk represented by the window. (Don't close the - 
window for a hard disk if you do not want it to be unmounted). 


When a file window is on top: 

FILE WINDOW - displays all the types of resources in the file 
Eile 
New - allows you to create a new resource of a new type (i.e. of a type that does not 
already exist in the file. To create a new resource of an existing type, open the window 
for that type and choose new from there). A dialog prompts you for the name of the 
new type. The types the resource editor knows how to edit (i.e. knows the format for) 
are listed in a scrollable standard-file-like window. if you wish to create a resource of a 
type that is not in this list, just type in the four letter resource type name. The resource 
editor will allow you to edit that resource in hex (or you may define a template for the 
resource specifying its format (much like the GNRL type in Rmaker), in which case you 
edit the resource by filling out a dialog box). See extensibility section below. 
Open (double-click) - opens the type window for the type selected. If you hold down 
the option key while double-clicking you will get the generic type window (which just 
lists the IDs of all the resources of that type in the file) rather than the type specific 
window (which for graphic types actually displays the resources). 
Close - closes the file window. If you have made any changes to the file (added, edited 
or removed resources from it) you will be asked if you wish to save the changes. This 
is the point at which your editing changes are either committed to the file or ignored. 
Revert - Undoes all the changes that were made to this file. This is equivalent to 
replying NO to save changes on a close except that the file and file window are not 
closed. 


ey 


The PickMenu procedure 
PROCEDURE PickMenu (menu, iem: integer; pick: PickHandle) ; 


PickMenu handles a menu selection (identified by menu and item) for a standard picker 
referenced by pick. Call PickMenu from your picker's DoMenu procedure. 


The RCalcMask procedure 
PROCEDURE RCalcMask (srcPir, dstPtr: Ptr; srcRow, dstRow, beigbt, words: integer); 


RCalcMask calculates a mask for the given source bit image and puts it into the destination bit 
image. The parameters srcPtr and dstPtr reference the source and destination bit images; src Row, 
dstRow, height, and words define the area on which RCalcMask operates. For further information 
about bit images, see Inside Macintosh, Volume I, Chapter 6. 


The ResEdID function 
FONCTION ResEdID: integer: 


ResEdID returns the resource ID of the editor or picker that calls it 


The ResEditRes function 
FUNCTION ResEditRes: integer; 


ResEditRes returns the resource [D of the resource editor. 


The ResEverest procedure 
PROCEDURE ResEverest; 


ResEverest sets the current resource file to the last one opened. 


The RSeedFill procedure 


PROCEDURE RSeedFill (srcPtr, dsiPtr: Ptr; srcRow, dstRow, beigbt, words: integer; seedH, seedV: 
integer); 


Given a source bit image, a destination bit image, and a seed location, RSeedFill fills the bits in 
the destination with black. The parameters srcPtr and dstPtr reference the source and destination bit 
images; srcRow, dstRow, height, and words define the area on which RSeedFill operates; seedH 
and seedY define the seed location. For further information about bit images, see Inside Macintosh, 
Volume I, Chapter 6. 


The ScrapCopy procedure 
PROCEDURE ScrapCopy (VAR b: Handle); 


ScrapCopy copies the ResEdit scrap into the resource identified by 5. 
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Edit 

Cut - removes all the resources of the selected types from the file (and puts them in the 
scrapFile) 

Copy - copies all the resources of the selected types into the scrapFile. if you hold 
down the option key and select copy from the menu, then the resources selected are 
added to the scrapFile rather than replacing the previous resources cut or copied. 
(This is an APPEND TO CLIPBOARD function). 

Paste - pastes the resources in the scrapFile into the file. 

Clear - removes the resources in the selected type (but does not add them to the 
scrapFile) 

Duplicate - makes a second copy of all the resources in the selected types. The new 
resources are assigned new unique IDs. 


When a type window is topmost: 
TYPE WINDOW - displays ail the resources of the given type 
File 


New - creates a new resource of the given type and opens the editing window for that 
type so you may start editing the new resource. 

Open - brings up the editing window for resources of the given type. If you hold down 
the option key, you can edit the resource in hex (rather than in the nice graphic or 
template way). If you hold down the option and shift keys, you can choose to edit the 
resource using a different type's template. This is useful when you have have an alias 
for a well known type. (In Rmaker you did this by saying TYPE MINE = DLOG, for 
example, or more commonly, TYPE MAPP = STR for your signature string in a bundle). 
To edit a MAPP resource, select STR from the list of types. 

Close - just closes the type window. 

Revert - undoes all the changes made to any of the resources of the given type. 

Get Info - gives information about the selected resource(s). This is where you can 
change the ID, name, and attributes of a resource. 


Edit 

Cut - Removes the selected resources from the resource file and adds them to the 
scrapFile. 

Copy - Copies the selected resources into the scrap file. Holding the option key down 
while making a copy adds the resource to the scrapFile without removing previous 
resources in the file. 

Paste - Pastes the resources from the scrapFile into the file that this type window 
belongs to. 

Clear - Removes the selected resources from the file without affecting the scrapFile. 
Duplicate - Makes a duplicate copy of the selected resource. 
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EXTENSIBILITY 


_ We knew that we could never anticipate the format of all the different types of resources 
that application writers would use so we designed the Resource Editor so that it could be 
taught to recognize and parse new resource types. There are two ways in which the 
Resource Editor can be extended to know about new types. One way involves 
programming and the other does not. 


1) Programming your own special purpose picker and/or editor. The picker is the code 
that displays all the resources of one type in the Type Window. The editor is the code 
that displays and allows you to edit a particular resource. These pieces of code are 
separate from the main code of the Resource Editor. information on writing custom 
pickers and editors will be provided in the future. 


2) Creating a template for your resource type - The generic way of editing a resource is 
to fill in the fields of a dialog box. This is the way you currently edit MENUs, DLOGs, 
DITLs, STR#s, STR s, INTLs, FREFs, BNDLs, etc. using the Resource Editor. The layout 
of these dialog boxes is determined from a template in the Resource Editor's resource 
fiie. You can find these templates by opening the Resource Editor file and then opening 
the type window for TMPLs. The template specifies the format of the resource and also 
specifies what labels should be put beside the editText items in the dialog box that is 
used for editing the resource. For example, if you open the template for WIND resources 
(this is the TMPL with name "WIND”), you see that they consist of: 

-4 words (a RECT) specifying the boundary of the window; followed by 

-a word which is the proc!D for the window (DWRD tells the resource editor to display 
the word in decimal as opposed to hex); followed by 

-a boolean (BOOL is 2 bytes in the resource but is duque as a radio button in the 
dialog window used for editing); followed by 

-another boolean indicating whether or not the window has a go away box; followed by 
-a long that is the refCon for the window (DLNG indicates that it should be displayed in 
the editor as a decimal number); followed by 

-a pascal string; the titie of the window (PSTR). 
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You can look through the other templates and compare them with the structure of those 
resources to get a feeling for how you might define your own resource template. The 
template mechanism is flexible enough to describe a repeating sequence of items within 
a resource as in STRif's, DITLs and MENUs. You can also have repeating sequences 
within repeating sequences as in BNDLs. A repeating sequence is terminated either by 
a 0 byte (as in MENUS), or by a zero-based count that heads the sequence (as in DITLs), 
or by a one-based count that starts off the sequence (as in STR#s), or it ends at the end 
of the resource (no example exists in the given templates). Different codes are put in the 
template to distinguish these different sequence types (LSTZ-LSTE (trailing O byte), 
ONCT/LSTC-LSTE (one-based count), ZONT/LSTC-LSTE (zero-based count), 
LSTB-LSTE (ends at end of resource). The types you have to choose from for your 
editable data fields are: 


DBYT,DWRD,DLNG - decimal byte, word, long. 

` HBYT,HWRD,HLNG - hex byte, word, long. 

HEXD - hex dump of remaining bytes in resource. 

PSTR - a pascal string (length byte followed by the characters) 
LSTR - long string (length long followed by the characters) 
ESTR,OSTR - pascal string padded to even or odd length (needed for DITLs) 
CSTR - a C string 

BOOL - boolean. 

BBIT - binary bit. 

TNAM - type name (like OsType and ResType. ie 4 characters) 
CHAR - a single character 


The Resource Editor will do the appropriate type checking for you when you put the 
editing dialog window away. 


To create your own template, 

Open the Resource Editor file window. 

Open the TMPL type window. 

Choose NEW from the file menu. 

Select the ***** list separator. 

Choose NEW from the file menu. You may now begin entering the label,type pairs 
which define the template. Before closing the template editing window, 

Choose GET INFO from the file menu and set the name of the template to the name of 
your resource type. 

Close the Resource Editor file window and save changes. 


The next time you try to edit or create a resource of this new type, you should get the 
dialog box in the format you have specified. 
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ResEdit: 
A Macintosh Resource Editor 


About ResEdit 


ResEdit is a graphically based tool for use by developers in creating the various resources 
needed to produce a Macintosh application. It allows you to create, edit, copy, and paste 
resources, and includes individual resource editors for specific types of resources. 


ResEdit may be used to change existing resource files; for example, you can translate the 
message in an alert box into another language without recompiling the program. Or it can 
be used to do a quick prototype of user interfaces and to try out many different formats and 
presentations of resources to find the one that's best suited for a given application. 


ResEdit is still in development. When completed, it will allow you to create and edit all 
resource types except CODE, and to copy and paste all resource types (including CODE). 
It will also include the option of producing an output file from which the Resource 
Compiler RMaker can create a resource file. 


A key feature of ResEdit is its extensibility. You can create new editors to manipulate new 
resource types and then add them to ResEdit. The simplest type of editor, a template 
editor, can even be created with ResEdit itself. 


Working with Files in ResEdit 


To begin using ResEdit, select its icon and choose Open from the File menu, or double- 
click the icon. ResEdit displays a window for each disk volume currently mounted. Each 
window shows a complete list of files on that volume. 


To examine the resources for a given file, select it from the list by clicking its name or by 
typing the first character of the name (in which case it will be scrolled into view if it's not 
visible). Then open the file by choosing Open from the File menu. You can also double- 
click the file name to open the file. 


If you choose Close or click the close box for a disk window, the volume will be 
unmounted. If it's a 3 1/2-inch disk, the disk will be ejected. ResEdit will recognize a new 
disk when it's inserted and also handles more than one drive. Be careful not to click the 
close box for a disk window that represents a hard disk, since it will unmount the hard 
disk. 
The New command lets you create a new file. 

Note: You can edit any file shown in the window, including the System file 

and ResEdit itself. However, it's dangerous to edit a file that's currently 


running. Edit a copy of the file instead (for example, the System file on a 
non-boot volume). Note that you cannot use ResEdit to copy or delete files. 
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selector that's invoked. If the Option key is held down during the open, the general 
resource selector is invoked. 


When a resource type window is the active window, the File menu commands have the 
following effects: 


+ New creates a new resource and opens its editor. A selection window is 
presented to allow you to select the resource type to create. 


٠ Open opens the appropriate editor for the resource you selected. 
۰ Close closes the resource type window. 


٠ Revert changes the entire file back to what it was before opening the resource 
type window. 


٠ Quit returns to the Finder. 
The Edit menu commands have the following effects: 
٠ Undo may or may not be selectable, depending on the specific editor in use. 
« Cut removes the resources that are selected, placing them in the ResEdit scrap. 
٠ Copy copies all the resources that are selected into the ResEdit scrap. 


٠ Paste copies the resources from ResEdit scrap into the resource type window's 
resource list. 


+ Clear removes the resources that are selected, without placing them in the 
ResEdit scrap. 


٠ Duplicate creates a duplicate of the resources that are selected and assigns a 
unique resource ID number to each new resource. 


Editing Individual Resources 


To open an editor for a particular resource, either double-click the resource or select it and 
choose Open from the File menu. All the editors use File and Edit menus similar to those 
described above, but operating on individual resources or individual elements of a 
resource. If you hold down the Option key when opening a resource, the general Data 
editor is invoked. The Data editor allows you to edit the resource as hexadecimal data. If 
both the Shift and Option keys are held down during opening, ResEdit shows you a list of 
editors available for the resource. Some editors, such as the DITL editor, allow you to 
open additional editors for the elements within the resource. 


One or more auxiliary menus may appear, depending on the type of resource being edited. 


The menus for some of the editors are discussed below. The use of the remaining editors 
should be apparent from their presentation when running. 
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٠ Use RSRC rect restores the enclosing rectangle to the rectangle size stored in 
the underlying resource. Note that this works on ICON, PICT, and CNTL items 
only; the other items have no underlying resources. 


٠ Resize window adjusts the window size so that all items in the item list are 
visible in the window. 


Editing Font Resources 


For FONT resources, the editor window is divided into three panes: the text pane, the 
character selection pane, and the character editing pane. 


The text pane appears in the upper right of the window. It displays sample text in the font 
being edited. The text may be edited using normal Macintosh editing techniques (in case 
you want a sample of other characters in the font). 


The character selection pane appears below the text pane. You can select a character you 
want to edit by clicking on it in the row of three characters shown. The character you select 
is boxed in the center of the row with its ASCII value shown below it. If the character you 
want is not displayed, click on the right character in the row to move upward through the 
ASCII range, or click on the left character to move downward. 


You can also select a character for editing by typing it. When the insertion point is not in 


the text pane, any character you type (using the Shift and Option keys if necessary) 5 
selected. 


The character editing pane on the left side of the window contains an enlargement of the 
selected character. The enlargement is similar to FatBits in MacPaint, and is edited by 
clicking bits on and off. The black triangles at the bottom of the character editing pane set 
the left and right bounds—that is, the character width—of the character in the font. 


Any changes you make in the character editing pane are reflected in the text pane and the 
character selection pane. Remember that you cannot save the changes until you quit. 


The Height menu contains the following commands: 
٠ More Ascent adds one bit to the length of the font ascent each time it's chosen. 


٠ More Descent adds one bit to the length of the font descent each time it's 
chosen. 


۰ Less Ascent subtracts one bit from the length of the font ascent each time it's 
chosen. 


٠ Less Descent subtracts one bit from the length of the font descent each time it's 
chosen. 


You can also change the name of a font. The name of the font is stored as the name of the 
resource of that font family with size 0. This resource does not show up in the normal 
display of all fonts in a file (in the FONT window). To get it to be displayed, hold down 
the Option key when you open FONT from the file window. This will bring up the generic 
list of fonts. Select the font with the name you wish to change and choose Get Info. 
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٠ a word that is the procID for the window (DWRD tells ResEdit to display the 
word in decimal as opposed to hex) 


٠ a Boolean inidicating whether or not the window is visible (BOOL is 2 bytes in 
the resource but is displayed as a radio button in the dialog window used for 
editing) 

another Boolean indicating whether or not the window has a close box 


٠ along that is the refCon for the window (DLNG indicates that it should be 
displayed in the editor as a decimal number) 


٠ a Pascal string; the title of the window (PSTR) 
You can look through the other templates and compare them with the structure of those 
resources to get a feeling for how you might define your own resource template. The 
template mechanism is flexible enough to describe a repeating sequence of items within a 
resource as in STR#'s, DITLs, and MENUs. You can also have repeating sequences 
within repeating sequences as in BNDLs. The different ways of terminating a repeating 
sequence, and the codes to put in the template to distinguish them, are as follows: 

+ LSTZ-LSTE - terminated by a 0 byte (as in MENUS) 


+ ZCNT/LSTC-LSTE - terminated by a zero-based count that starts the sequence 
(as in DITLs) 


© OCNT/LSTC-LSTE - terminated by a one-based count that starts the sequence (as 
in STR#s) 


+ LSTB-LSTE - ends at the end of the resource (no example exists in the given 
templates) 


The types you have to choose from for your editable data fields are: 
e» DBYT, DWRD, DLNG - decimal byte, word, long 
e HBYT, HWRD, HLNG - hex byte, word, long 
e HEXD - hex dump of remaining bytes in resource 
٠ PSTR - a Pascal string (length byte followed by the characters) 
٠ LSTR - long string (length long followed by the characters) 
+ ESTR, OSTR - Pascal string padded to even or odd length (needed for DITLs) 
۰ CSTR - aC string 
٠ BOOL - Boolean 
+ BBIT - binary bit 
+ TNAM - type name (like OSType and ResType, i.e., 4 characters) 
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Un Who 


Note: As in Inside Macintosh, resource type names are shown within single quotes; for 
example, ‘STR '. The quotes are not part of the name. 


About ResEdit 


ResEdit is an interactive, graphically based tool for manipulating the various resources 17 a 
Macintosh application. It lets you create and edit all resource types except ‘CODE’, and to 
copy and paste all resource types (including 'CODE'). ResEdit actually includes a number 
of individual resource editors: these include a general resource editor, for editing any 
resource in hex format, and several individual resource editors for specific types of 
resources. You can also write your own resource editors fo use with ResEdit. 


ResEdit is especially useful for creating and changing graphic resources such as dialogs or 
icons. For example, you can use ResEdit to put together a quick prototype of a user 
interface and try out different formats and presentations of resources. ResEdit is also 
useful for translating resources into a foreign language without having to recompile the 
program. 
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٠ CHAR - a single character 


ResEdit will do the appropriate type checking for you when you put the editing dialog 
window away. 


To create your own template: 

1. Open the ResEdit file window. 

2. Open the TMPL type window. 

3. Choose New from the File menu. 

4. Select the ***** list separator. 

5. Choose New from the File menu. You may now begin entering the label, type 
pairs that define the template. Before closing the template editing window, 
choose Get Info from the File menu and set the name of the template to the name 
of your resource type. 


6. Close the ResEdit file window and save changes. 


The next time you try to edit or create a resource of this new type, you should get the dialog 
box in the format you have specified. 
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Figure 2 A File Window 


When a file window is the active window, the File menu commands have the following 


effects: 
( 
New . Creates a new resource in the open file. 
Open Opens a window displaying all resources of the resource type selected | 


(select the resource type by clicking it or by typing its first character). 


Note: The resources are displayed by a resource picker—the general 
resource picker displays the resources by type, name, and ID number; 
there are also special resource pickers for some resource types (for 
example, the 'ICON' resource picker displays the icons graphically). 
If you hold down the Option key while opening, the resource window 
will open with the general resource picker. 


Open General Opens the general resource picker. 

Close Closes the file window and asks if you want to save the changes you 
made. Never reboot before closing! If you have made any changes, 
rebooting before closing all file windows can leave the resource files in 
an inconsistent state. 


Revert Changes the resource file back to the version that was last saved to 
disk. 


The Edit menu commands have the following effects: 


Cut Removes all resources of the resource types selected, placing them in 
the ResEdit scrap. 
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Working within a File 


Opening a file creates a window displaying a list of all the resource types in that file. When 
a file window is the active window, a new resource may be created, existing resources may 
be copied or deleted, and resources may be pasted in from other files. The File menu 
commands have the following effects: 


٠ New creates a new resource in the open file. 


٠ Open opens a window displaying all resources of the resource type selected; 
select the resource type by clicking it or by typing its first character. You can also 
double-click the resource type to open. The resources are displayed by a 
"resource selector". There's a general resource selector that displays the 
resources by type, name, and ID number, and for some resource types there's a 
special resource selector for that type (for example, the ICON resource selector 
displays the icons graphically). If you hold down the Option key while opening, 
the resource window will open with the general resource selector; do this if, for 
example, you want to see icons listed by type, name, and ID. 


Close closes the file window and asks if you want to save the changes you 
made. Never reboot before closing! Rebooting before closing ail file 
windows can leave the resource files in an inconsistent state if you have made any 
changes. 


Revert changes the resource file back to the state it was in when it was last saved 
to disk. 


٠ Quit returns to the Finder. 


When a file window is the active window, the Edit menu commands have the following 
effects: 


e Cut removes all resources of the resource types selected, placing them in the 
ResEdit scrap. 


٠ Copy copies all resources of the resource types selected into the ResEdit scrap. 


٠ Paste copies the resources from the ResEdit scrap into the file window's 
resource type list. 


. Clear removes all resources of the resource type selected, without placing them 
in the ResEdit scrap. 


The Duplicate command is currently dimmed: in the final release of ResEdit, this 


command will create duplicates of all resources of the resource types selected, and assign a 
unique resource ID number to each new resource. 


Working within a Resource Type 


Opening a resource type creates a window with a list of all the specific resources of that 
type in the file. This list can take many forms, depending on the underlying resource 
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Close Closes the resource type window. 


Revert Changes the entire file back to what it was before opening the resource 
type window. l 


The Edit menu commands have the following effects: 


Undo May or may not be selectable, depending on the specific editor in use. 

Cut Removes the resources that are selected, placing them in the ResEdit 
scrap. 

Copy Copies all the resources that are selected into the ResEdit scrap. 

Paste Copies the resources from ResEdit scrap into the resource type 
window's resource list. 

Clear Removes the resources that are selected, without placing them in the 
ResEdit scrap. 

Duplicate Creates a duplicate of the selected resources and assigns a unique 


resource ID number to each new resource. 


Changing a Resource's Type 

۱ 
If you hold down the Option key when copying or duplicating a resource, a dialog box 
with a list of resource types will be presented. You may choose any of these types, or type 
in your own type name that the copy/duplicate will be forced to become—that is, you may 
coerce the copy to a new resource type. (BE CAREFUL!!! —know what you are doing 
before trying this.) | 


Editing Individual Resources 


To open an editor for a particular resource, either double-click on the resource or select it 
and choose Open from the File menu. One or more auxiliary menus may appear, 
depending on the type of resource being edited. Some editors, such as the 'DITL' editor, 
allow you to open additional editors for the elements within the resource. All the editors 
use File and Edit menus similar to those described above, but operate on individual 
resources or individual elements of a resource. 


If you hold down the Option key when opening a resource, the general data editor is 
invoked—this allows you to edit the resource as hexadecimal data. If you hold down the 
Shift and the Option keys while opening, ResEdit shows you a list of all editors and 
templates. 

Caution: Individual editors may not be appropriate for all resource types. 


The menus for some of the editors are discussed below. The use of the remaining editors 
should be apparent when you run them. 
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Changing the name for this one resource will change the nzme for all the fonts in this 
family. 


Editing ICN# Resources 


For ICN# resources, the editor displays two panes in the window. The lower pane shows, 
from left to right, what the icon will look like unselected and selected on a white 
background, and unselected and selected on a gray background. The upper pane is used to 
edit the icon. It contains an enlargement of the icon on the left and an enlargement of the 
icon's mask on the right. 


The Icn# menu contains the following command: 
٠ Data->Mask copies the icon image to the mask editing area. 


To install a new icon for your application when you already have an old one in the Finder's 
desktop: Open the file called DeskTop. Open type BNDL and find the bundle that is your 
application's. (This is the one that has your owner name in it.) Look through the bundle 
and mark down the type and resource ID of all resources bundled together by the bundle 
(i.e., the ICN#'s and FREF's). Go back to the DeskTop window and remove these 
resources along with your BNDL and signature resource (the resource with type name = 
your creator type). Now close the DeskTop window, save changes, and quit ResEdit. 
Your new icon will be installed. 


Extensibility 


Since it can't anticipate the format of all the different types of resources that application 
developers will use, ResEdit has been designed so it can be taught to recognize and parse 
new resource types. There are two ways that ResEdit can be extended to know about new 
types. One way involves programming and the other does not. 


You can extend ResEdit by programming your own special-purpose resource selector 
and/or editor. The selector is the code that displays all the resources of one type in the 
resource type window. The editor is the code that displays and allows you to edit a 
particular resource. These pieces of code are separate from the main code of ResEdit. 
Information on writing custom selectors and editors will be provided in the future. 


Another way to extend ResEdit is by creating a template for your resource type. The 
generic way of editing a resource is to fill in the fields of a dialog box. This 1s the way you 
currently edit MENUs, DLOGs, DITLs, STR#s, STR 5, INTLs, FREFs, BNDLs, etc. 
using ResEdit. The layout of these dialog boxes is determined from a template in ResEdit's 
resource file. You can find these templates by opening the ResEdit file and then opening 
the type window for TMPLs. The template specifies the format of the resource and also 
specifies what labels should be put beside the editText items in the dialog box that's used 
for editing the resource. For example, if you open the template for WIND resources (this 
is the TMPL with name "WIND"), you see that they consist of the following, in the order 
listed: 


٠ 4 words (a RECT) specifying the boundary of the window 
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Use RSRC Rect Restores the enclosing rectangle to the rectangle size stored in the 
underlying resource. Note that this works on 'ICON', ‘PICT’, and 
'CNTL' items only; the other items have no underlying resources. 


Resize Window Adjusts the window size so that all items in the item list are visible in 
the window. 


FONT Resources 


For 'FONT' resources, the editor window is divided into three panes: a sample text pane, 
a character selection pane, and a character editing pane. These are shown in Figure 5. 


4 Fonts trom System 


The quick 
brown fox 
jumps over 


the lazy dog. 





X 





Figure 5. FONT Editor Window 


The sample text pane, at the upper right, displays a sample of text in the font being edited. 
(You can change this text by clicking in the text pane and using normal Macintosh editing 
techniques.) | 


The character selection pane is below the text pane. You can select a character to edit by 
typing it (using the Shift and Option keys if necessary), or by clicking on it in the row of 
three characters shown. (Click on the right character in the row to move upward through 
the ASCII range; click on the left character to move downward.) The character you select 
is boxed in the center of the row with its ASCII value shown below it. 


The character editing pane on the left side of the window shows an enlargement of the 
selected character. Like FatBits in MacPaint, it's edited by clicking bits on and off. The 
black triangles at the bottom of the character editing pane set the left and right bounds Q.e., 
the character width). The three triangles at the left of the pane control the ascent, baseline, 
and descent. 
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You can also extend ResEdit by creating templates for your own resource types. The 
generic way of editing a resource is to fill in the fields of a dialog box—this is the way you 
currently edit 'BNDL's, 'FREF's, 'APPL's, etc. The layout of these dialog boxes is 
determined from a template in ResEdit's resource file—you can add templates to edit new 
resource types. | 


Using ResEdit 


To start ResEdit from the Finder, select and open the ResEdit icon. ResEdit displays a 
window that lists the files for each disk volume currently mounted. 


Working with Files 


To list the resource types for a file, select and open the file name from the list. (You can 
select aname by clicking it or by typing one or more characters of the name.) 


When a disk volume window is the active window, the File menu commands act as 
follows: | 


New Creates a new file. ۱ 
Open Opens the selected file (this is the same as double-clicking on the file name). 
Get Info Displays file information and allows you to change it. 


Close Closes the volume window (this is the same as clicking the close box). If 
it's a 3 1/2-inch disk, the disk will be ejected. 
Caution: You can edit any file shown in the window, including the System file 
and ResEdit itself. However, it's dangerous to edit a file that's currently running. 
Edit a copy of the file instead (for example, the System file on a non-boot 
volume). 


Note that ResEdit will recognize a new disk when it's inserted and also handles more than 
one drive. 


Note also that you can use ResEdit to copy or delete files. 


Working within a File 


When you open a file, a window displays a list of all the resource types in that file. While 
this window is the active window, you can create new resources, copy or delete existing 
resources, and paste resources from other files. 
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+ a Boolean indicating whether or not the window is visible (BOOL is 2 bytes in the 
resource but is displayed as a radio button in the dialog window used for editing) 


+ another Boolean indicating whether or not the window has a close box 


٠ along that is the refCon for the window (DLNG indicates that it should be displayed 
in the editor as a decimal number) 


٠ a Pascal string; the title of the window (PSTR) 


You can look through the other templates and compare them with the structure of those 
resources to get a feeling for how you might define your own resource template. 


The types you have to choose from for your editable data fields are: 
DBYT, DWRD, DLNG — decimal byte, word, long 
HBYT, HWRD, HLNG — hex byte, word, long 
HEXD — hex dump of remaining bytes in resource 
PSTR — a Pascal string (length byte followed by the characters) 
LSTR — long string (length long followed by the characters) 
WSTR — same as LSTR, but a word rather than a long 
ESTR, OSTR — Pascal string padded to even or odd length (needed for DITLs) 
CSTR — a C string 
ECST — even-padded C string 
OCST — odd-padded C string (padded with nulls) 
BOOL — Boolean 
BBIT — binary bit 
TNAM — type name (like OSType and ResType, i.e., 4 characters) 
CHAR — a Gast character 
Hnnn — 3-digit hex number (where nnn > $900); displays nnn bytes in hex format. 


ResEdit will do the appropriate type checking for you when you put the editing dialog 
window away. 
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Copy Copies all resources of the resource types selected into the ResEdit 


scrap. 

Paste Copies the resources from the ResEdit scrap into the file window's 
resource type list. 

Clear Removes all resources of the resource type selected, without placing 
them in the ResEdit scrap. 

Duplicate Creates duplicates of all resources of the resource types selected, and 


assigns a unique resource ID number to each new resource. 


Working within a Resource Type 


Opening a resource type produces a window that lists each resource of that type in the file. 
(This list will take different forms, depending on the underlying resource picker that's 


invoked; if you hold down the Option key during the open, the general resource picker is 
invoked.) 


LA File Edit 





Figure 3. A Resource Type Window 


When a resource type window is the active window, the File menu commands have the 
following effects: 


New Creates a new resource and opens its editor. A selection window is 
presented to allow you to select the resource type to create. 


Open _ Opens the appropriate editor for the resource you selected. 
Open General Opens the general (hexadecimal) resource editor. 
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About REdit 


Every Macintosh application uses resources such as menus, icons, dialog and alert 
boxes and the text they contain, and others. REdit lets you edit these resources easily. 
(To change the size or position of a dialog box, for example, you just drag its title bar or 
"size box." ( You can use REdit to customize applications for your own language or 
just to satisfy your own whims. 


How to Use REdit 


Insert a disk that contains REdit. 

If you have a two-drive system, REdit can be on a separate disk from the one you 
want to edit. If you have a one-drive system, you have to copy REdit to the disk you 
want to edit. You can't edit a file you're currently using; if you want to edit a disk's 
System File, for example, start up the Macintosh using a different startup disk. 


Open REdit by selecting its icon and then choosing Open from the File menu, or by 
double-clicking the icon. 


Choose Open from the File menu. 
Click the name of the file you want to edit, and then click Open. 


Use the Drive button to see the files on a disk in a second drive, or use the Eject 
button to eject the current disk so you can insert another. 


A window appears, with icons representing each resource type that exists in the file 
you selected. 


Open the icon that represents the resource type you want 0 edit. (For now, you need 
to open the icons by double-clicking them.) 


A window appears, with an icon representing each resource. Each resource 5 ID is 
shown below its icon. 


Double click each icon, in turn, to open it and make changes to the resource it 
represents. 


You'll have different options, depending on the kind of resource you're editing: 


Note: The general data editor will not edit resources larger than 16K bytes in 
length; however, you can move larger resources with the Cut, Copy, Paste, and 
Clear commands as described above. 


CURS Resources 


For 'CURS' resources, the editor displays three images of the cursor. All three images 
may be manipulated with the mouse. 


The left image shows how the cursor will appear. The middle image 15 the mask for the 
cursor, which affects how the cursor appears on various backgrounds. The right image 
shows a gray picture of the cursor with a single point in black—this point is the cursor's 
hot spot. 


The Cursor menu contains the following commands: 


Try Cursor / | 
Restore Arrow Try Cursor lets you try out the cursor by having it become the 
cursor in use. Restore Arrow restores the standard arrow cursor. 


Data —>Mask Copies the cursor image to the mask editing area. 


DITL Resources 


For 'DITL resources, the editor displays an image of the item list as your program would 
display it in a dialog or alert box. When you select an item, a size box appears in the 
bottom right corner of its enclosing rectangle so that you can change the size of the 
rectangle. You can move an item by dragging it with the mouse. 


If you open an item within the dialog box, the editor associated with the item is invoked; 
for an ICON’, for example, the icon editor is invoked. If you hold down the Shift and 
Option keys while opening, the 'DITM' editor is invoked instead—this is a special-purpose 
editor for editing items in an item list. If you hold down just the Option key while opening, 
the general data editor is invoked. 


The DITL menu contains the following commands: 


Bring to Front Allows you to change the order of items in the item list. Bring to 
Front causes the selected item to become the last (highest numbered) 
item in the list. The actual number of the item is shown by the 
DITM' editor. 


Send to Back Like Bring to Front, except that it makes the selected item the first 
item in the list—that is, item #1. | 


Grid Aligns the item on an invisible 8 pixel by 8 pixel grid. If you 
change the item location while Grid is on, the location will be 
adjusted such that the top left corner lies on the nearest grid point 
above and to the left of the location you gave it. If you change the 
size, it will be made a multiple of 8 pixels in both dimensions. 
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— Ifit's a picture, you can use the Clipboard to replace the current picture with one 
you paste in. 


— If it's text, you can edit it by typing or using any of the commands in the Edit 
menu. 


— If it's a dialog or an alert box, you can change the size of the box by dragging 
the small square in the bottom right corner of the box. | 


- If it’s an item list, you can change the placement and size of items within dialog 
and alert boxes, or double-click the item to edit its text. After you've changed. 
items, open the corresponding alert or dialog box and make sure the box is the 
right size. (The box resource usually has the same ID number as the item.) 


When you click the OK (or Cancel) button, you return to the window displaying the 

individual resources. If you're editing an alert or a dialog box, there's an additional 
menu— Alert— in the menu bar to confirm or cancel your changes. [This gives you 
nearly the entire screen to make your changes to the box.] 


When you return to the window that displays the resources, the ID number of each 
resource you changed is highlighted, so you can easily check back to make sure the 
resources you edited are the way you want them. If they're not, you can change them 
again before you save any of the changes. 

٠ Choose Save from the File menu to save the changes you made to the resources. 


٠ Close the window to return to the overview of the resource types. 


Caution: Changing the ascent or descent of a character changes the ascent or descent 
for the entire font. 


Any changes you make in the character editing pane are reflected in the text pane and the 
character selection pane. Remember that you cannot save the changes until you quit. 


You can also change the name of a font. The font name is stored as the name of the 
resource of that font family with size 0. This resource does not show up in the normal 
display of all fonts in a file. To display it, hold down the Option key when you open 
FONT from the file window. This will bring up the generic list of fonts. Select the font 
with the name you wish to change and choose Get Info. 


ICN# Resources 


For 'ICN# resources, the editor displays two panes in the window. The upper pane is 
used to edit the icon. It contains an enlargement of the icon on the left and an enlargement 
of the icon's mask on the right. The lower pane shows, from left to right, how the icon 
will look unselected, selected, and open on both a white a gray background. 


To install a new icon for your application when you already have an old one in the Finder's 
desktop file: 


1. Open the file called DeskTop. — 


2. Open type BNDL' and find the bundle that is your application's. (This is the one 
that has your owner name in it.) Look through the bundle and mark down the ty 
and resource ID of all resources bundled together by the bundle (i.e., the ICN#'s and 
FREF's). 


] 
3. Go back to the DeskTop window and remove these resources along with your 
BNDL' and signature resource (the resource whose type name = your creator type). 


4. Now close the DeskTop window, save changes, and quit ResEdit. Your new icon 
will be installed. ۱ 


Creating a Resource Template 


You can customize ResEdit by creating new templates for your own resource types. The 
generic way of editing a resource is to fill in the fields of a dialog box—this is the way you 
currently edit FREF's, 'BNDL's, 'STR#'s, etc. The layout of these dialog boxes is set by 
a template in ResEdit's resource file. The template specifies the format of the resource and 
also specifies what labels should be put beside the editText items in the dialog box that's 
used for editing the resource. You can find these templates by opening the ResEdit file and 
then opening the type window for 'TMPL's. For example, if you open the template for 
WIND?’ resources (this is the "TMPL' with name "WIND"), you'll see that they consist of 
the following, in the order listed: 


* a RECT (4 words) specifying the boundary of the window 
٠ aword that is the procID for the window (DWRD tells ResEdit to display the word in 
decimal as opposed to hex) 
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The template mechanism is flexible enough to describe a repeating sequence of items within 
a resource, as in 'STR#'s, 'DITL's, and 'MENUS. You can also have repeating 


sequences within repeating sequences as 1n 'BNDL's. To terminate a repeating sequence, 
put the appropriate code in the template as follows: 


LSTZ-LSTE terminated by a O byte (as in MENU's) 
ZCNT/LSTC-LSTE terminated by a zero-based count that starts the sequence (as in 
| | '"DITL's) 
OCNT/LSTC-LSTE terminated by a one-based count that starts the sequence (as in 
'STR#'s) 
LSTB-LSTE ` ends at the end of the resource (no example exists in the given 
templates) 


To create your own template: 
1. Open the ResEdit file window. 
2. Open the 'TMPL' type window. 
3. Choose New from the File menu. 
4. Select the list separator. 
5. Choose New from the File menu. You may now begin entering the label,type pairs 


that define the template. Before closing the template editing window, choose Get Info 
from the File menu and set the name of the template to the name of your resource 


type. | 
6. Close the ResEdit file window and save changes. 


The next time you try to edit or create a resource of this new type, you'll get the dialog box 
in the format you have specified. 
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Every application for the Apple Macintosh™ computer uses resources such as 
menus, icons, and dialog and alert boxes and the text they contain. REdit lets you 
edit these resources to customize applications for your own language or just for 
your own whims. If you're interested in "serious" programming for the Macintosh 
computer, see /nside Macintosh. 
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Using REdit Insert a disk that contains the REdit application. 


If you have a two-drive system, the application can be on a separate disk from the one 
you want to edit. If you have a one-drive system, Copy REdit to the disk you want to 

edit. You can't edit a file you're currently using. If you want to adit a disk's System file, 
for example, start up the Macintosh using a different startup disk. 


- 


Open REdit by selecting its icon and then choosing Open from the File 
menu, or by double-clicking the icon. 


Choose Open from the File menu. 


Use the Drive button to see the files on a disk in a second drive, or use the Eject button 
to eject the current disk so you can insert another. 


Click the name ot the file you want to edit, and then click Open. 


A directory window appears, with icons representing each resource type that exists in 
the file you selected. Resource types that can't be edited have a question mark icon. 


File you're editing 












Icon list 


Item list 
String list 
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Double-click the icon that represents the resource type you want to edit. 





Another window appears, with an icon representing each resource of the type you 
opened that exists in the file you opened. Each resource's ID is shown below its icon. 


To make changes to an individual resource, double-click its icon. 


You'll have different options, depending on the type of resource you're editing. 
Descriptions of the various types follow. 
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Editing a Picture (resource type PICT) 


You can use the Clipboard to copy the current picture, edit it with another application, 
and paste it in again, or just replace the current picture with another you paste in: 


Cut 


Replace picture with 
contents of Clipboard 


Shaw Clipboard 


Resource type 


Resource ID 
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Editing Text (resource type STR) 


You can edit text by typing or using any of the commands in the Edit menu: 


Resource ID 











Resource type 


Text you can edit Save document as: 


Editing a String List (resource type STR#) 


You can click your way through the group of strings, Or type the string number you want 
in the box at the top right and then click the String button. Edit any of the strings in the 


usual way. 


Resource ID 


Resource type 


String you can edit 








Click to edit the string 
whose number you type 
to the right 





Type the number 
you want 
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Editing a Menu 


You can change any of the commands, Command key equivalents, or menu titles, and 
you can disable a command. To change a menu title, select the existing title and edit it: 
to change a command, select it in the menu that appears at the right and type the new 


command in the Command blank. Use the Set button to set each changed title or 
command. When you've set all the changes you want to make, click OK. (If you 
change only one command or title, clicking OK sets that change automatically.) 




















€ File Edit Options 





Command you're 
editing 





Title: 


Command: 


Edit menu title 


Fdit selected 
command 


Command key 
equivalent 


Enable or disable 
Set changes 
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Editing a Window (resource type WIND) 


You can change the size of the window by dragging the small square in the bottom 
right corner of the box or move the box anywhere on the screen by dragging any other 
part of the window. You can change the title of a window or define tts exact 
coordinates by choosing WIND Info from the Window menu. 
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Choose WIND Info 
Cancel, or OK 


Drag anywhere to 
move window 


Drag to change 
window's size 
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Editing a Dialog Box or an Alert Box (resource type DLOG or ALRT) 1 
You can change the size of the box by dragging the small square in the bottom right i 
corner of the box or move the box anywhere on the screen by dragging any other part 
of the box. Open the corresponding item list resource to edit the contents of the alert 
or dialog box. (The item list resource usually has the same ID as the dialog or alert 
resource; choose DLOG or ALRT info from the Dialog or Alert menu to check.) You can 
change the title of a dialog box by using the DLOG Info command in the Dialog menu. 
€ ۵ 
Show Item Rectangles 
Choose to see related DLOG Info... 
item list or to name the Cancel 
dialog box OK 
3 Type: 
4 Resources: 
A Drag anywhere to move 
>. window J Undo Changes 
db Drag to change | 
n window's size 
f 
$ 
| 
| 
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Editing an Item List (resource type DITL) 


You can change the placement and size of items within dialog and alert boxes. 
There's also a Grid command in the Item List menu to align items, along with OK and 
Cancel commands to confirm or cancel your changes. 


Up to four text parameters can be specified using “0, “1, ^2, and ^3. You can edit the 
text strings in STR or 5 18#. However, to find the text strings, you may need to know à 
little about how the application works. 


Drag to move item 


Drag to change item size 


You can double-click the item to edit its text or exact coordinates. After you've edited 
items, open the corresponding alert or dialog box to make sure the box is the right size. 


Click to edit the item 
whose number you 
type to the right 









Type the number you 
want 






———— 
DITL 258 Items: 9 


| Rect: 45 20 61 100 StatTent Disabled 


6996 —— werl[as | 









Resources: 
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Double-click to edit text 


Resource ID 
Resource type 


Current rectangle 
coordinates 


New coordinates 


String you can edit 
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Editing a Control (resource type CNTL) 


You can set its size and title: 


Resource ID 





CNTL 256 Invisible Scroll Bar 


bottom: right: 


Title: 


Ke) 
















Resource type 





Rectangle coordinates 








Title you can edit 


Editing an Icon 


You can click or drag to change dots: 






ICON 262 





Resource type 
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line so you can easily fill it in. 





Usually the mask is the outline of the ico 
The Copy button lets you copy the current out 


You can edit the icon and the icon mask used by the Finder on the desktop 


Editing an Icon List (resource type ICN#) 


highlighting and selection criteria. 


black. 





Editing an International Resource (resource type INTL) 
You can change the various ways you want time, dates, numbers, and currency to 


appear. (You can also use the Localizer application to change to a country's standard 
international resources.) 


Months: 


Saturday O Suppr. Bayname L] Leading 0 day* 


Str 0..4: [ |] rd 
O.Dd*M.y. abbr: [s | 
© .D.M.d#.y. Country: o | [y 0K | 


Decimal Point: 


(€) $KH @ (HH) @ inches 
O HHS O -HH O metric 


($) 0 (€ 0.۷ O 24 hrs 
OR © -HR O 12 hrs 


Ko. sec. RIO. min. FJ 0. hrs 
[]0. days [10. month [J centuries 


(9 m/d/y Country: [o | 


© d/m/y 


O w/m 


Thousands Sep.: 





* 
H 


Wa 
1 e 


List Separator: 






i 


est 


LULA 
Käse 
^ 


Time Separator: 






Date Separator: 


N 
" 
m 
a 


oa 


Currency: 

First 12 hr.: 
Last #2 hr.: 
24 hr.: 
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ES 
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ia 
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Saving or Undolng Changes 


You can confirm or undo any changes you make to an individual resource by clicking 
OK or Cancel. (If you're editing a Dialog, Alert, or Item List, OK and Cance! appear in a 
menu instead of as buttons. This gives you the entire screen to work in when you're 
changing the size of windows or dialog boxes.) 


When you click the OK (or Cancel) button in an individual resource, you return to the 
directory window that displays all the resources of the type you opened in the file 


you're editing. 


The ID number of each changed resource is highlighted, so you can easily check back 
to make sure the resources you edited are the way you want them. No changes are 
saved until you choose Save from the File menu. 







٩۶۶1 ۶ 
eB, ea 


B, 


Similarly, in the directory window that shows all resource types in the current file, each 
type that contains a changed resource is highlighted. 
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REdit Reference 


A changed resource 
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Choosing Save from the File menu when either directory window is active saves all 
changes you made to the resources in the current file; choosing Revert leaves the file 
as it was when you opened it. You can undo changes to an individual resource or to 
an entire type by selecting its icon, choosing Info from the File menu, and clicking Undo 
Changes. 


Type: INTL iD: 0 


Name: 


Size: 32 Ly Undo Changes 





Cutting and Pasting in REdit 


resource type (also by clicking its icon) to copy to the Clipboard and paste into the 
same file or another file. Use some caution in cutting and pasting. (For example, it 
wouldn't be a great idea to replace MacPaint's dialog boxes with those of MacWrite.) 
REdit will paste only where it makes sense to do so—text into text resources, pictures 


: You can select text, a picture, an entire resource (by clicking its icon),or an entire 

H 

E 

into picture resources, and so forth. If a resource type doesn't match, you'll be warned. 
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About REdit... 


Choose Printer 


The Apple Menu 





Scrapbook 
Alarm Clock 
Note Pad 
Calculator 
Key Caps 
Control Panel 
Puzzle 













About REdit... 


Contains the version number and the name of the author of REdit—Gerard 
Schutten—and the number of bytes currently available in memory. 


Desk Accessories 


See Macintosh, the owner's guide, for a description of Macintosh desk accessories. 


The File Menu 


Open 
Info... 


Close 


Pee 


banesa 


Save 
Revert 


Decompile... 


A Sense Peek teens ee 


Quit #0 





The File commands generally work on entire files while you're using REdit. 
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Quit 


Closes the file you're editing and quits the application. If you've made any changes to 
the file since you last saved it, you'll be asked whether you want to save these 
changes. 


The Edit Menu 









ndo 
Cut 36H 
Copy aec 
Paste aeu 
Clear 





e 


Patch Data 


ere 14044 094r ووم ون‎ P o HR nh man 


Show Clipboard 


Undo 

In REdit, Undo is dimmed unless you're using a desk accessory. 

Cut 

Removes whatever text is selected and places it on the Clipboard. In REdit, Cut works 
only with text. See the Copy command below for editing pictures, entire resources, OF 
an entire resource type. 


Copy 


Copies whatever is selected and places it on the Clipboard. It can be text, a picture, an 
entire resource, or all resources within a type. 


Paste 


Places a copy of the contents of the Clipboard at the insertion point. REdit allows you 
to paste only when it makes sense. See "Cutting and Pasting in REGit." 


Clear 


Removes whatever text is selected without placing il on the Clipboard. 1n REdit, Clear 
works only with text. 
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Patch Data 


Available when an individua! resource is selected. Patch Data is a low-level patching 
utility. Use it only if you're confident you know what you're doing; errors can cause 
serious problems. Patch Data gives you both a hexadecimal and an ASCII listing of 
the selected resource so you can modify individual bytes of data—no matter which type 
it is. 


Use the Tab key to switch between the hexadecimal and ASCII representations. 


The Window Menu 











Window 
WIND info... 
Cancel 

OK 


Available when you're editing a window resource. 

WIND Info... 

Shows the resource type, 1D, whether it's immediately visible or not, whether or not 
there's a close box, the window’s position on the screen (which can be changed by 
dragging the window), and the title, which you can edit. 

Cancel 

Closes the resource you're currently editing, canceling any changes you've made to it. 
OK 

Closes the resource you're editing, storing in memory any changes you've made to it. 


The changes you've made are not actually saved on disk until you choose Save from 
the File menu. 
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The Alert Menu 







Show Item Rectangles 
ALRT Info... 

Cancel 

OK 






Available when you're editing an alert resource. 
Show Item Rectangles 


Displays the current size and placement of the alert's items. (You can change the size 
and placement using the item list resources; choose ALRT Info to find the 
corresponding item list.) 


ALRT Info... 

Displays the resource type and ID, the stages of severity, the window's position on the 
aa (which can be changed by dragging the window), and the corresponding item 
Cancel 

Closes the resource you're currently editing, canceling any changes you've made to it. 
OK 

Closes the resource you're editing, storing in memory any changes you've made to it. 


The changes you've made are not actually saved on disk until you choose Save from 
the File menu. 


The Dialog Menu 








Show Item Rectangles 
DLOG Info... 

Cancel 

OK 


Available when you're editing a dialog resource. 
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Show Item Rectangles 


Displays the current size and placement of the dialog's items. (You can change the 
size and placement using the item list resources; choose DLOG Info to find the 
corresponding item list.) 


DLOG Info... 


Displays the resource type and ID, whether the dialog is immediately visible or not, 
whether or not there's a close box, the dialog box's position on the screen (which can 
be changed by dragging the box), the corresponding item list, and the title (if there is 
one), which you can edit. 


Cancel 

Closes the resource you're currently editing, canceling any changes you've made to it. 
OK 

Closes the resource you're editing, storing in memory any changes you've made to it. 


The changes you've made are not actually saved on disk until you choose Save from 
the File menu. 


The Item List Menu 


item list 
Grid... 
Cancel 
DK 







Available when you're editing an item list. 





Grid 
Lets you align items at the top or bottom, left or right on grid marks you specify. 


Cancel 


MÀ € ee‏ سے پا ا سیم س 


Closes the resource you're currently editing, canceling any changes you've made to it. 


OK 
Closes the resource you're editing, storing in memory any changes you've made to it. 


The changes you've made are not actually saved on disk until you choose Save from 
the File menu. 
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" 


i What is Factfinder?" Think of Factfinder" as your electronic "desk drawer’ where you can 
= enter your information free-form, easily organize and store It, CrOSS- 
e reference it with other pieces of information; then find it again using 
whatever criteria you choose. 


The Factfinder program is both visual and intuitive: you can store your 
information just as you think about it; in a free-form, unstructured way. 
Factfinder requires no forma! data fields and records. You no tonger have 
to shove your ideas into someone else's little boxes—boxes that may 
work for them, but not for you. 


Factfinder was developed for the Macintosh" and uses its features to 
their best advantage. You'll be working in a familiar environment. 


Here'show Factfinder can work with you, and with your Macintosh: 


When you start up your Macintosh system, a "working desktop” is 
displayed. Your own desktop may contain your day’s work schedule, 
incoming mail, outgoing documents, research for an upcoming 
project, company documents, phone messages, and articles to be 
read and catalogued. To deal with all this material, most people 
organize their work into piles or "stacks" of related topics or tasks. In 
Factfinder, that's just what you'll do, too. 
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Later, when you need to retrieve some information; you'd like to do it 
without having to sort through a stack, piece by piece. The ability to 

quickly find a piece of information (or a group of related items!) is one of 

the main benefits of the Factfinder program. Ina "stack," you might 

tag, or highlight, or jot down notes on a document so you can 

remember and find it later. Factfinder too, lets you associate names, 
highlighted phrases or keywords, and dates with your document, and 

store as many as you want in a stack. Later, you can easily retrieve 
documents by having Factfinder search your stack based on these 
"keys. 
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Factfinder even creates a complete index of all your keys for each 
stack. You can display this index to get an overview of the contents of 
the stack, and quickly select what you want to use for search 
instructions. The index includes the unique name that you gave to each 
of your stored documents, all the keys you associated with them, and 
even tracks the dates when you created and modified them. You can 
use any combination of these things to search through the stack and 


retrieve your documents. 
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Factfinder lets you do your own work, in your own way. 
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INTRODUCTION 


Editors 
Eile article notes, contact names, and source data for upcoming 
attractions and feature spreads. 


Professors 
Store class notes and dissertation abstracts for future reference. 


Sports Managers 
Categorize players by ability and prepare scouting reports for future 
negotiations. 


Salespeople 
Prepare and maintain call reports, cllent and customer files, Status 
reports, new account records and phone and mailing lists. 


If you need to keep track of important people and information, youhave a 
need for Factfinder, too. 
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r, E Reference 
| 3 A quick synopsis of the purpose of each command (organized by menu), 
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r P n Explains how to merge Factsheets from different Factfinder stacks, as 
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A QUICK TOUR OF FACTFINDER 


The Factfinder Quick Tour is designed to get you up and running as soon 
as possible. Spend about a half-hour doing the Quick Tour—you Il 
practice with a stack of Factsheets called Examples that are included on 
your program disk. 


There are many more features in Factfinder than you will practice in this 
Quick Tour. You can find out all about them in the chapters Using 
Factfinder and Reference, later in this manual. 


Since you need a Macintosh to run Factfinder, it's probably safe to 
assume that you're at least a beginning Macintosh user. You should be 
familiar with how to: 


O Setup your Macintosh and insert a disk. 
O Move the mouse and use it to select items and text. 


O Work with windows (open, close, resize, activate, move, and scroll 
them). 


O Use pull-down menus and respond to "dialog boxes” (messages that 
require your input). 


[ Do simple text editing. 
DO Cut or Copy, and Paste text. 


O Work with items on the Macintosh desktop, such as files, folders, and 
icons. 


[] Use your printer. 


Factfinder uses these Macintosh features, so you'll be working in a 
familiar environment. If you've listened to the Macintosh Guided Four, you 
know enough to begin enjoying Factfinder. 


If you haven't taken the Macintosh Guided Tour, or if youneedarefresher, 
don't worry. You can learn everything you need to know in about an hour. 
Listen to the cassette tape that came with your system, try out a few 
things, browse through the manuals (no need to study them) . . . and 
you're ready to begin learning and using Factfinder. 


As you take the Factfinder Quick Tour, follow each step and read the 
explanations as they guide you through using the program. You will be 
reminded how to use many of these basic Macintosh features as you work 
in Factfinder. 


So, welcome to Factfinder. Your Tour is about to begin...relax and enjoy 
yourself! 
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A QUICK TOUR OF FACTFINDER 


During this Quick Tour, you'll be using the stack of Factsheets called 
Examples. The other two stacks, Gallery and Hints, will be helpful later as 
you use the program for your own work. They are explained in 


Appendix C. 


Ye 


To open a stack: 


E Move the pointer onto the Examples stack icon, then click the 
mouse button. 


B Pull down the File menu and select Open. 


The Factfinder program starts automatically and the stack you 
selected opens. Your screen should look like this: 


Find window 
Names Found window 
"Active window’ bars 
Close button 


F é File Edit 






Factfinder menu bar 
eus “Utility Help 


Stack Fac 


ere peak 
















Factsheet window 





Welcome to Factfinder! 
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When you open a stack that already 
has Factsheets in it, the first one 
(on top' of the stack) appears here. 
This is the Factsheet window 






13 Factsheets in Stack 
13 Factsheets found 


else AS 
Johnson Corp 

International Expansion 
Company Profile 
Investment Recommendat 

ı Assignments 
Telephone Cali Report 
Inventory 
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Over there on the right ------------ 
is the Names Found window It 
displays a list of all the Factsheets in 
the stack A list of the keywords for 
this Factsheet is in the Keys window 
underneath the Names Found 
window. 
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AQUICK TOUR OF FACTFINDER 


B Click on the Factsheet window to activate it; then: 
8 Click on the browse button at the right. 


This is the browse forward button that displays the next Factsheet 
listed in the Names Found window. 


E Click on the browse button at the left. 


This browse backward button does the opposite—it displays the 
previous Factsheetlisted in the Names Found window. Right now, you 
should see the same Factsheet you left a minute ago. 


Use the browse buttons to look at a few more Factsheets until you feel 
comfortable browsing through the stack. Next, you'Illearnhow to make a 
Factsheet of your own... 


MUNDUS 
Now that you know your way around the Factsheets already in the 
Examples stack, it's time to add a new Factsheet of your own. 


The steps you'll use to create a Factsheet are similar to the ones you'd go 
through in dealing with information at your own desk: 


(] Take a fresh piece of paper and write down your information. 


[J Highlight or jot down important points or "keys" that you'll want to 
remember about that information (and that would later heip you 
categorize or file it). 


Put the paper into a stack of other papers.‏ لأ 
To "take a fresh piece of paper:‏ 
M Pull down the Factsheet menu and select New.‏ 
Notice that most commands in Factfinder have a corresponding‏ 


command key (in this case 36 N} that you can use instead of selecting 
from a menu. You can find out about all of these in later chapters. 


Your new Unnamed Factsheet appears in the Factsheet window, 
ready for youtotype in your own information. Anempty Keys window 
also comes to the front, where you'll enter some keys to remember 
about this Factsheet. (You'll use Factsheets' keywords later to find 
them in the stack.) 
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A QUICK TOUR OF FACTFINDER 


The next step you'll take on your Quick Tour is to attach some keywords 
to your new Factsheet. These keywords become a sort of highlighting or 
special key to the information in the Factsheet, and will help you find it 
later in the stack (By the way, the program also saves the dates on which 
you create and modify each Factsheet, as well as the name you'll give it, 
so you can also use these later to find the Factsheet). 


To attach some keywords to your Factsheet: 


m Select the word “Factsheet” in the first line of the text you typed 
{Put the I-beam pointer right before the first letter, click and hold 
the mouse button while dragging the pointer to the end of the 
word; then release the button). 


If you make a mistake, simply click and start selecting again. Now that 
your keyword is selected: 


m Pull down the Keys menu and select Mark. 
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The program adds your first keyword to the Keys window. Notice that 
the keyword is entered in all capital letters. Because Factfinder is not 
sensitive to uppercase and lowercase letters, you can enter names 
andkeywords with any combination of case, and also easily search for 
them regardless of case. 


g Usethesame technique to attach these five keywords to your 
Factsheet: 
Factfinder 
type 
text wrap 
save 
edit 


Pr سوسس سے‎ rin 05 rata - El e MA ر‎ * we - 
- 5 . oe ۳ ~ a 


p- 


Attaching Keywords 
to the Factsheet 


= Yy 


۱ > 
| | 


Y 
م‎ 4 
P 
bp 
bp 
p 
" 
ly > = 
p 3 
n 
bp = 
pe, = 
d 
the 
"or 


MMR RNN 
W للل‎ a لقا‎ u u uj لقا لا لكا لقا لقأ‎ us لقا نفا لقا‎ 


E 


mmmmmnhmmtm 


[ 


| 









n mwera yaaa .ر‎ sa a o 


A QUICK TOUR OF FACTFINDER 


8 Type procedures and then click on the Add button. 
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Your newest keyword is listed alphabetically along with all the others 
you marked directly from the Factsheet. 


If you made a mistake on any keyword(s} and now want to delete 
one or more of them, simply click on the keyword to select it; then 


click on the Delete button. 


Well done! Now it’s time to save your Factsheet... 
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A QUICK TOUR OF FACTFINDER 
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B Click on the OK button (OR press the Return key); that's all you 
have to do to save your Factsheet! 


Name for Facisheet: 


¡My first Factsheet | 





| OK 5 Cancel | | 


Factfinder updates the number of Factsheets in your stack, and 
continues to display your saved Factsheet with its new name. 


Your Factsheet ts saved in the stack 
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You could select New again to create more new Factsheets. Your number 
of Factsheets is limited only by your available disk space. But for now, 
you're about to learn how to search the stack and find just the Factsheets 
you want... 
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p. A QUICK TOUR OF FACTFINDER 


الا 


Factfinder tells you what's happening, and gives you the option to stop 
the search. Then, the Names Found window comes to the front 0 
displays the names of those Factsheets that satisfied your search 
criteria. The first of those Factsheets Is displayed in the Factsheet 
window: 
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You can now look through your "tound'' Factsheets as you did in the 
beginning of the Quick Tour, or you can try some more searches 
through the stack. Here are some more examples of search 
instructions that make them a bit more usefut: 
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B Activate the Find window again. 


You can ‘‘refine’’ your instructions by adding more criteriathat must be 
met before a Factsheet is found. Factfinder offers you several different 
‘‘operators’’ you can Use in composing your search instructions. They 


let your instructions be evaluated much like a math equation. 





You'li find explanations of how to use all of these in the next two 
chapters of this manual. For now, you'll try three: or, and, and ( Jto see 
how they affect your search. 


m Add to your instructions so they read text or apple. 
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A QUICK TOUR OF FACTFINDER 


= Activate the Find window again and try each of these next two 
searches: 


text or apple and window 
This finds Factsheets only if they have BOTH keywords text AND 
window, or if they have BOTH keywords apple AND window. 


After you select Find Factsheets, you should see twoFactsheets listed 
in the Names Found window. 


text or (apple and window) 

(Move the |-beam pointer to right in front of apple and click there; then 
insert the left parenthesis. Do the same for the right parenthesis after 
window). This applies a precedence to your search instructions: you Il 
Find Factsheets with the keyword text, along with Factsheets that 
contain BOTH apple and window. 


After you select Find Factsheets, you should see three Factsheets 
listed in the Names Found window. 


Now, finish up by Finding all the Factsheets in the stack again: 


B Click on the Find window, use the backspace key to erase your 
last search instructions, type a//and then select Find Factsheets 
one last time. 


There are many more combinations of keywords, names, dates, and 
operators you can use to retrieve Factsheets from your stacks. As you 
beginto do your own work in Factfinder, you can learn all about them in the 
chapters Using Factfinder and Reference. For now, you'll learn how to 
print a copy of a Factsheet... 
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A QUICK TOUR OF FACTFINDER 





Next, you see the familiar Macintosh print dialog box: 


=" 


B Click on the OK button. 
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Quality: © Hıgh CO Standard C» ۲۱ 
Page Range: ۶ Ail C: From: أ‎ | To: 
Copies: 

Paper feed: ® Continuous O Cut Sheet 
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reaches the right border 


Next, IN note some things to remember about this Factsheet on its Keys 
window, then seve it ol} in the stack Locke good! 
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Congratulations! Your Factfinder Quick Touris almost over, now. You 
only need to learn how to leave the program... 
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USING FACTFINDER 


This chapter explains how to do a variety of tasks with the Factfinder 
program. Here you'll find more details than in the Quick Tour (hope you 
took the Tour!) along with many additional Factfinder features and 
capabilities. 


Each section describes a task, explains the details; then gives you step- 
by-step instructions on how to perform it. You'll also find some short- 
cuts and alternate ways to make the tasks easier. 








To start Factfinder: 
B Turnonyour Macintosh; then insert your Factfinder program disk. 


B “Double click” the Factfinder disk icon on your Macintosh | 
desktop (OR select Open from the File menu). | 


W Doubleclick” the Factfindericon to start the Factfinder program 
(OR click once; then select Open from the File menu). 


Factfinder disk icon 
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the Factfinder 
Program 
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USING FACTFINDER 


E Fillin the dialog box with a name for your new stack; then click on 
the OK button. 


Create steck named: Factfinder... 


| 








Factfinder creates your new stack and displays an unnamed 
Factsheet, ready for your first entry. 


There are two ways you can openan existing stack: starting from the 
Factfinder disk display on the desktop, or after you have closed one stack 
in the program and then want to open another. 


To opena stack directly from the desktop: 


8 “Double click” onthe stack icon you want to open (OR click once; 
then select Open from the File menu). 


B The Factfinder program will start, and automatically open your stack. 










Factfinder'" ESS 








Errpty Folder Gallery Hints 
508 


Factfander * Help 





Opening an Existing Stack 


Stack (of Factsheets} icon 
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B Click once on the name of the Factsheet in the list; then click on 


B Click on the “browse forward” button on the right, 


E Click onthe "browse backward” button on the left. 


To display Factsheets from the Factsheet window: 


B Activate the Factsheet window (click on it). 


USING FACTFINDER 


the Display button. 
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Fri, Aug 21, 1964 1256 3 


Tinternatianal Expansion 





OR 


Over there on the right ------------ > 
is the Names Found window. It 

displays a list of all the Factsheets in 
the stack A list of the key words for 
this Factsheet ıs in the Keys window 
underneath the Names Found 
window 









The “browse forward” button displays the next Factsheet listed in the 
Names Found window, and the "browse backward” button displays 
the previous one. 
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USING FACTFINDER 


There are two ways you can close the stack you re using: 


B Activate the Names Found window (this window represents the 
entire stack); then click on the close button, 
OR 

B Puli down the File menu and select Close Stack. 
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Names Found 
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13 Factsheets found 
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Page Setup 
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Quit 









Welcome 

Johnson Corp 
International Expansion 
Company Profile 


Investment Recommendat 
Assignments 

Teiephicne Call Report 
Inventory 
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Fri, Aug 31, 1964 1 06 PM 


Once you quit the Factfinder program, you can delete any unlocked stack 
from the Macintosh desktop: 


B Click and hold the mouse button on the stack icon you want to 
delete. 


B Drag the stack icon onto the "trash can” icon; then release the 
button. 


Remember: when a stack is locked you cannot delete it. You can, 
however, unlock it without restarting Factfinder. Pull down the Macintosh 
File menu and select Get Info; then click on the Lock button. Do the steps 
above again. Once the stack is in the trash can, you must select Empty 
Trash from the Special menu to actually delete it. See "Protecting a 
Stack” for more information on locking and unlocking a stack. 


Close button 


Closing a Stack 


Deleting a Stack 
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USING FACIFINDER 


[1 Resizing a window - Standard Macintosh button in the lower right of a 


window. When the window's active, click and hold on the button; then 
drag the outline to the new size and release. Appears in the Factsheet 
and Find windows. 
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; Scroli down 
Es Resize button 


O The Zoom button - Special Factfinder button in the lower left of the 
Factsheet window. When the window is active, click on the button to 
quickly enlarge the window to full size. This is also the size of your 
printed page, and handy for previewing your layout before you print. 
The button is a toggle: when you ve zoomed open a window, the 
button changes to unzoom. Clicking it again returns the window to its 
previous size. Appears only in the Factsheet window. 








- 


5 ae A - gea ۳ 
ar Le ۰ E 0 
ai. 


_. A | ~ 


» r 
[ m 


H 


Hu uu uuu uuu uu ai ۱ 


¡TO 
3ry 


her 
OW 
IOW 





B-A 
a 








USING FACTFINDER 


If you haven't saved your current Factsheet before you select New, 
Factfinder gives you the opportunity to do so (and name it, if 
necessary). Then, a new Factsheet is displayed with its Keys window, 
ready for you to enter text. 


Factsheet Keys Utility 
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You cantypetextintoaFactsheet with any arrangement youlike. You can 
position the I-beam pointer anywhere in your Factsheet text; then click to 
position the insertion point. As you type, your text automatically wraps 
around to the next line when it reaches the right border. To force aline to 
end, press the Return key. When your text reaches the bottom border, the 
Factsheet automatically scrolls up to give you more space to enter text. 
You can use the scroll bar to move your Factsheet text up or down. 


Whenever you resize or zoom a Factsheet window, your text 
automatically rewraps to the new size. Zooming also shows you the way 
your Factsheet will look when you print it with standard (12-point) 
characters. | 


You can use the editing features that are familiar to Macintosh users. 
Here's a summary of what's available: 


Insert 

Position the I-beam pointer where you want to insert text; then click to 
move the insertion point there. Now just type; existing text gets pushed 
to the right. 
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USING FACTFINDER 





۲ ۲ 7 


= Click on the close button of the Factsheet you want to save. 
This lets you save the Factsheet and removes both the Factsheet and 
Keys window. You can then display another Factsheet from the Names 
Found list, or you can create a New Factsheet. 
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Close button 





| welcome to Factfinder, Change Name 





fı Find Factsheets conteining 
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In the last two cases, Factfinder displays the save dialog box asking if 
you want to save your Factsheet: click on the Yes button. 


i 


Factfinder saves your Factsheet with its same name, unless you 
haven't named it yet.... 


If the Factsheet you're saving is still Unnamed, Factfinder next displays a 
dialog box where you must type a unique name, before the Factsheet can 
be saved: 


5 Just start typing a name (up to 7 characters); then click on the 
OK button. 


Factfinder names the Factsheet and saves it in the stack. 


DEED 
Changing the Name of a B With the Factsheet window active, pull down the Factsheet 


Factsheet menu and select Change Name. 


(or 
Ck 


+ ro * 


Factfinder displays a dialog box where you can enter a new name. 
¡for 
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E Just start typing a new name; then click on the OK button. 


Your new name displays on both the Factsheet and the Keys window. 
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Printing One or More Factfinder offers you many options that let you decide what you want to 
Factsheets print and how you want the printout to look on the page. 
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USING FACTFINDER 


The first four options work together: 


E Select the first one to print only Factsheet text (without its name, 


dates, orkeywords). 
OR 


E Select as many of the next three options as you want, they let you print 
the name, dates, and keywords along with Factsheet text. 


The next two options let you set your paper length, and a size for the 
bottom margin; the last option lets you choose either standard or 
compressed print. 


For example, say you had created Factsheets containing the name, 
address, and information on clients, vendors, family, friends, or 
whomever. Now you would like to print the name and address part of 
each Factsheet on standard "one up”’ mailing labels. 


Here's how you could print your mailing labels: 


E Put the name and address on the first three or four lines of each 
Factsheet: something like this: 


Mr. James Smythe, CEO 
Galaxy Enterprises, Inc. 
1478 ع‎ Drydock Avenue 
East Kiakuk, lowo 50600 


Galaxy is a manufacturer and 
marketer of stress-tested, 
reinforced mine tunnel support He 
clamps. They currently contro! 75% | 7 
of the market for support clamps. te 
Revenue for 1986 is expected to 
grow by 33% although the entire pi 
market size is shrinking by 27% per | = 
year due to new innovations in n 
optically inspected support clamps. 
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USING FACTFINDER 


g When your Page Setup dialog box is complete. click on the OK 
button. ۱ 


Note that the Cancel button lets you remove your changes and go back 
to the previous settings. Once you click on the OK button, your Page 
Setup settings are used for all your printing until you change them 
again. 


g When you're ready to print your labels, you'll select Print from the 
File menu (as described in the next section), select which 
Factsheets to print; then click on the OK button. 


Next; you'll see the Macintosh Print dialog box. If you set From: 1 To: 1 
as your Page Range, Factfinder will print the first inch of each Factsheet 
(the name and address) as "page 1° of that Factsheet...then go onto 
print "page 1 of the next Factsheet. 
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Quality: @ High O Standard ۱ Gic | 
Page Range: OAI @ From: 1 | To: CEN 

Copies: 

Paper Feed: € Continuous © Cut Sheet 
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Click on the OK button to start printing the labels.‏ و 


Of course, you'll want to experiment a little with your Page Setup to fine- 
tune the measurements for your particular labels and the number of lines 
in your names and addresses. Here's a sample of how they can be 
printed: 









Mr. James Smythe, CEO 
Galaxy Enterprises, Inc. 
1478 E Drydock Avenue 
East Kiakuk, lowa 50600 







Dr. Jayne Smithers, PhD 
University of Natural Sciences 
1228 Y. Midway Avenue 

Westwood, Ak 72000 
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USING FACTFINDER 


Factfinder prints the option you selected according to the settings in your 
Page Setup dialog box. See ""Deciding How and What to Print from each 


Factsheet'' for details. 


WX cm o» 
You can delete one Factsheet at a time, or several! Factsheets in one 
operation. Before you can begin deleting, the Factsheet(s) you want to 
delete must be ‘‘found” (listed in the Names Found window), and the 
Names found window must be active. 


To delete one Factsheet at a time: 


w Select the Factsheet's name from the Names Found window list 


(click on it). 


E Pull down the Stack menu and select Delete Selected (or type 


Utility 
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USING FACTFINDER 


When you want to move or copy text from one Factsheet to another, you 
use the Macintosh clipboard. Because your text is kept on the clipboard 
(outside of Factfinder) you can move or copy the text to other Factsheets, 
even in another stack. 


Move and Copy work almost the same way. To move text, you first select 
and Cut it from the displayed Factsheet (remove it); then you display the 
other Factsheet and Pastethe text there. To copy text, youfirst select and 
Copy it from the displayed Factsheet; then display the other Factsheet 
and Paste it there. 


® Display the Factsheet; then select the text you want to move or 
copy (highlight it). 


E Pull down the Edit menu and select Cut (to move it) or Copy (to 
copy it}. 
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The text is either removed or copied onto the Macintosh clipboard. Next, 
you'll display the Factsheet where you want to insert that text: 


To display another Factsheet in the same stack: 
¥ Actvate the Names Found window; then select and Display the 


other Factsheet. (Factfinder prompts you to save your changes 
first; click the Yes button). 
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USING FACTFINDER 


Mí "d 


ui 


Note that the text stays on the Macintosh clipboard unti! you do 
another Cut or Copy command. This lets you copy or move that same 
text into as many other Factsheets as you want by simply saving the 
displayed one; then displaying the next one and selecting Paste again. 
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You can even open a MacWrite document and cut or copy text. Once 
the text is on the clipboard, things work just as though you had gotten 
the text from another Factsheet. Bringing text from Factfinder into 
MacWrite works just as easily. 
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Copying Factsheets into You can take all the Factsheets listed in the Names Found window (all or 

another Stack (Merging part of the stack, as you please), Unload copies of them into a text file; 

Stacks) then open another stack and simply Loadthemin, using two commands in 
the Utility menu. This lets you merge Factsheets from as many stacks as 
you please into one stack. The only limit you have is the size of your disk. 
Later, you can delete the separate stacks from the Macintosh desktop, if 
you only want to keep the stack with all the merged Factsheets in it. 
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You can also create a text file using MacWrite or another program and, as 
long as it’s in a format that Factfinder can understand, you can load it into 
a stack, too. 
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All the details for Loading and Unloading Factsheets and text files are 
contained in Appendix A. 
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Attaching Keywords When you create a Factsheet, you'll want to note important points or 

to a Factsheet information about what you've entered there. By attaching keywordstoa 
Factsheet you can reference and cross-reference it with other 
Factsheets, and quickly retrieve it later by doing a search on those 
keywords. 
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4 


There are two ways you canattach keywords to a Factsheet: by selecting 
and marking them right in your Factsheet text, or by typing them on the 
Keys window. 


iN) ım 
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Note: Factfinder keywords are not sensitive to the difference between 
uppercase and lowercase letters. You can enter and easily search for 
keywords with any combination of case. If you want to attach dates as 
keywords, you simply enter them in the form mm/dd/yy; for example, 
8/15/84. 
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Before you begin attaching keywords to a Factsheet, it's a good idea to 
display the Keys window (click on it, if necessary), so you can see your 
keywords as they are added. 
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Stack Factsheet REIL Utility 
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E Next, ۱۱۱ note some things to 

B remember about this Factsheet on 
B its Keys window, then seve 1t ell in 
EE the stack Looks good! 


A special feature you may want to use: 

When you first save a Factsheet and are typing a name for it (or when 
you're changing a Factsheet's name), you can mark words from that 
name as regular keywords. For example, if your Factsheet name were 
Activity Report — June 1984, you might want to make each word or 
two into a separate keyword. Simply select the word(s); then type 36 ۰ 





You can type in your keywords directly on a Factsheet's Keys window: 


B Activate the Keys window. The insertion point appears in the box 
at the bottom of the window. 


B Type in your keyword; then press the Return key, OR press the 
Enter key, OR click on the Add button. 
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pa USING FACTFINDER 
Pr: 
5p 
b: 
a B To delete all the keywords, simply click on the Clear Keys button. 
وم‎ bt 
مس سس سس‎ 
py += Using Automatic When you create several Factsheets that deal with a common subject, 
Keywords you'll probably want to attach some keywords that they'll also have in 
p rx common. You can save time by using the Automatic Keywords window. 
p a For example, suppose you were entering abstracts of all the articles in an 
-= issue of a magazine. You might want each Factsheet to have a keyword 
_ for the title of the magazine, the issue number, and the date. You could 
bp a enter those keywords onthe Automatic Keys window, and they would be 
added to each Key window as soon as you created the Factsheet. Then, 
E you would only need to add the keywords that were unique to each 
" Factsheet. 
Eu 5 ۱ ۱ 
It's important to remember that Automatic Keywords will be added 
= a beginning with the next Factsheet you create. A blank Factsheet that is 
already displayed will not have the automatic keywords. You can simply 
E close that blank Factsheet window and not save it; then select New from 
y ou the Factsheet menu. 
P E a E Pull down the Keys menu and select Show Automatic. 
nt po: The automatic Keys window displays next to the Factsheet window. 
Es Keys 
i; Mark EM 
pe x Shout Automatic p. 
Don't Add Automatic 
= = 
m mm will BE edded m 
| to new Factsheets 
m هد‎ mE 
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E: m Delete tipar Keys 
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USING FACTFINDER 


Of course, the Automatic keywords remain on the Automatic Keys 
window until you delete them (follow the same steps as for deleting 
regular keywords, above) So, you can decide to use or not use them, 
(and even add or remove some or al! of them) whenever you wish. 


pM rM ME. 
Every Factsheet has a unique name (that you gave it), and can have as 
many keywords attached to it as you want (you're only limited by your 
available Macintosh memory). Factfinder also keeps track of the date you 
create each Factsheet as well as the date you last modified it. You can use ۱ 
any of these to compose search instructions that will let you Find your 
Factsheets in the stack. 


MM 
The instructions you compose to Find Factsheets in the stack can contain 
any combination of keywords, Factsheet names, creation dates, and 
modification dates. Factfinder is not sensitive to the difference between 
uppercase and lowercase letters for keywords and names; so, you can 
enter them in any way you want. If you attached dates as keywords, you 
simply enter them as mm/dd/yy; for example, 5/19/47. 


> لويس و لم موب عم ميد م عند مووي را‎ D! 


Find in Examples 
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Name Assignments or (kirk and 
“meeting nates”) or (created 
B/16/84 to created 8/20/84) 
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Finding Factsheets in 
the Stack 


Composing Search 
Instructions 
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= Compare that with (text or apple) and window. Here, a Factsheet must 
rq have BOTH text AND window, or it must have BOTH apple AND window 
to be found. 


| W 
u ويد وق جم هد‎ ee uu EE s i 


m om m m m m Mm 


found 

ri stands for all the Factsheets retrieved in your previous search. You can 
use this operator to either expand or limit your further searches; for 

3 example, found or foreign - keeps all the factsheets already found and 

includes them along with any other Factsheets containing the keyword 

foreign. 
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On the other hand, you could limit your next search this way: found and 
X foreign - Factfinderlooks through the Factsheets already found AND finds 
only the ones which also include the keyword foreign. 


mi c ? | 
This is a ‘wildcard’ you can put on the end of partial keywords or | 
Factsheet names. It can stand for any remaining characters, for example, 


contain? would find Factsheets with the keyword(s) container, 
ry contained, containing, containment, etc. 
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3 Some points to remember: 


O 
7 


rà B Whenever you are using keywords longer than one word, you'll have 

to enclose the entire keyword in quotes; for example “Carolyn A. | 
Ross''. Otherwise, Factfinder will evaluate it as three separate | 
keywords with an implied and operator between each one. As you can 

see, your Factsheet in question probably wouldn't be found! . 


HH 


You can enclose all your keywords in quotes, if you want to; thoughit's 
only necessary for multiple-word keywords. If you re also usinga?asa 
wildcard, be sure to put it OUTSIDE the quotes: “Galaxy Ente’? not 
"Galaxy Ente?". 
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If your keyword should already have some quotes embedded in it, 
don't worry. Simply use the other type of quotes (single or double) 
around the whole thing; for example, ‘William “Lefty” Jones’. 


e 
Ed 
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d all 
E If you have attached the words and, or, to, or foundto a Factsheet as 


keywords, you must enclose them in quotes when you do a Find. 
Because Factfinder uses them as operators, your search instructions 
could be interpreted other than the way you intended them. 
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5 If you don't use an operator between keywords, Factfinder will 
assume you mean and. 
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USING FACTFINDER 


Here's the order of what Factfinder puts in your stack 5 index. Note 
that if more than one Factsheet has the same keyword or date(s}, each 
key is only shown once. Names and keywords are listed alphabetically, 
while dates are listed chronologically. 


O The names of all the Factsheets (shown in italics) 

O Created dates (when you first saved any Factsheet). 
O Modified dates (when you last saved any Factsheet). 
O Dates you entered as keywords. 

O Numbers you entered as keywords. 

O Normal text keywords. 7 


When the list is longer than the window, you can use the scroll bars to 
scroll it up or down. There is also a special feature of the index window to 
let you move around in it quickly: a series of "tabs" to the index along the 
left border. 


8 Display a portion of the index that contains keys you want to 
select. (Click on a tab along the left border to quickly display an 
area, or use the window’s scroll bars). 


B Move any key to the Find window ("double click'' on it OR click 
once; then click on the Move button). 


ASS/ENMENTS 
BIBLE QUOTATION 
CALENDAR 8/15/84 
LCONFANV PROFILE 
DIARY له بر جع مرچ‎ 
HIGH-TECH NAGALINE 
INTERNATIONAL EAFA.. 
INVENTORY | 
INVESTMENT RECO... 
JOHNSON CORE 
JOURNAL ABSTRACT 
MY FIRST FACTSHEET 
TELEPHONE CALL REF... 
WEL CONE 
Created an 88/16/64 
Created on 09/05/84 
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USING FACTFINDER 


if NO Factsheets are found, Factfinder informs you. You can always 
activate the Find window, change your instructions, and try again. 


There are no Fecisheets which satisfy thts 
Request 





if Factsheets ARE found, they are listed in the Names Found window. 
The status line tells you how many were found, and the first Factsheet 
in the list is aisplayed in the Factsheet window. 


Your Factfinder disk comes with a special stack called Factfinder™ Help 
which appears as the Help menu at the top of your screen. When you pull 
down the Help menu, you can select any one of six commands that each 
display a labeled screen and a quick look at that item in the Factfinder 
program. 


When you first begin using Factfinder, you may find these screens helpful 
in remembering some program details while you work. Later, you can 
copy the Factfinder™ Help stack onto another disk for safekeeping; then 
delete it from your Factfinder program disk. This willlet you free up a 
considerable amount of disk space for your own work. 


Note that once you have removed the Help stack from the Factfinder 
program disk, the Help menu will no longer appear with the other menus 
at the top of your screen. ` 


Using the Help 
Screens 
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Introduction This chapter presents a brief guide to all the commands in the Factfinder 
program. The commands are grouped by menu, just as you see themin 
the Factfinder menu bar at the top of your screen. Whenever you pul! 
down a menu, you see the commands that functionally belong with that 
item. For example, the Factsheet menu contains the commands you can 
use ona single Factsheet: Save it, create a Newone, or Change one's 
Name. 


oa owe 


To find a brief description of a command and the ways it can be used, 
took under the name of the appropriate menu in this Reference. Of course, 
you can also find any command listed in the Index at the back of your 
manual. 
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To find the steps and explanations of the tasks you can perform using 
these commands, see the chapter Using Factfinder. 
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At the end of this chapter, you'll also find a section that briefly details 
Factfinder's Special Keys and Operators. Again, the steps for using them 
are in the chapter Using Factfinder. 
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Clear 


Lets you delete all the text 
you have selected in a 
Factsheet, or a Find 
window. (You can even 
delete text in any 
keywords or Factsheet 
names while you are 
entering them). 


Select All 


Lets you select all the text 
in your Factsheet or Find 
window. (You can even 
select the text in any 
keywords or Factsheet 
names while you are 
entering them). 


You can also type 3 A. 


Show Clipboard/Hide 
Clipboard 


Lets you display or close 
the Macintosh clipboard 
window, 50 you can See 
the contents that you 
have Cut or Copied there, 
and that you can now 
Paste. 


The command is a toggle: 


when you select one, the 
menu changes to the 
other. 


You can also close the 
clipboard window by 
clicking on itssclose 
button. 


You can then use Paste to 
move the text to another 
Factsheet, Keys window, 
Find window, or even 
another application which 
supports text files, such 
as MacWirite. 


You can also type 8$ X. 


Copy 


Lets you make a copy of 
selected text and put it on 
the Macintosh clipboard. 
You can take text from a 
Factsheet, or from Find 
instructions. (You can 
even take the text from 
any keywords or 
Factsheet names while 
you are entering them). 


You can then use Paste to 
copy the text to another 
Factsheet, Keys window, 
Find window, or even 
another application which 
supports text files, such 
as MacWrite. 


You can also type $8 C. 


Paste 


Lets you take the contents 
of the Macintosh 
clipboard and insert them 
beginning at the insertion 
point in the active 
window. 


You can thus move or 
copy text into Factsheets, 
Keys windows, Find 
windows, or even another 
application which 
supports text files, such 
as MacWrite. l 


You can also type 3 V. 
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The Edit Menu 






EL 


Clear 
Select All ÆR 


Show Clipboard 


Undo 


For convenience in using 
your Macintosh desk 
accessories, lets you 
undo operations you have 
performed using those 
accessories. 


See your Macintosh 
manual for details on 
using your Macintosh 
desk accessories. 


You can also type 2 


Cut 


Lets you remove selected 
text and put it on the 
Macintosh clipboard. You 
can take text from a 
Factsheet, or from Find 
instructions. (You can 
even take the text from 
any keywords or 
Factsheet names while 
you are entering them). 
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Lock Stack Unlock 
Stack 


Lets you apply or remove 
protection on your stack 
tokeep you from 
accidentally changing or 
deleting it. 


The command is a toggle: 
when you select one, the 
menu changes to the 
other. 


A stack can also be locked 
or unlocked from the 
desktop by selecting Get 
Info from the Macintosh 
File menu. 


Quit 


Lets you exit the 
Factfinder program. 


If you have an unsaved 
Factsheet when you 
select Quit, Factfinder 
gives you the opportunity 
to save it (and name it, if 


necessary) before exiting 


to the desktop. 


Note that when you select 


the Quit command, your 
stack is automatically 
closed at the same time. 
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Utility Menu 





Utility 
Load from text 
Unload to text 
Hard Disk Install 








Load from text 


Lets you bring a text file 
into your current stack as 
Factsheets. The text file 
can: 


8 contain Factsheet text, 
names, dates, and 
keywords that you 
previously Unloaded to 
text from another 
Factfinder stack. This lets 
you merge two stacks. 


m contain text from any 
application which 
supports text files, such 
as MacWrite. You must 
follow some special 
formats so that Factfinder 
canread these text files as 
Factsheets, dates, and 
keywords. 


See Appendix A for all the 
details. 


Once keywords are 
entered on the Automatic 
Keys window, you can 
decide when you want 
them added to new 
Factsheets. The default is 
to add them. See Add 
Automatic/Don't Add 
Automatic, below. 


Add Automatic/Don't 
Add Automatic 


Lets you begin or stop 
adding Automatic 
Keywords to the next and 
subsequent Factsheets 
you create. 


The command is a toggle: 
when you select one, the 
menu changes to the 
other. 


Closing the Automatic 
Keys window has no 
effect on these two 
commands. You can add 
Autometic Keywords 


even when you can't see | 


the window (and vice 
versa). 


Automatic Keywords 
remain on this window 
until you delete them; 50 
you can decide to use or 
not use them whenever 
you wish. The default is to 
add them. 
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The Keys Menu 







86M 
Show Rutomatic 
Don't Rdd Rutomatic 


Mark 


Lets you select up to 28 
characters from your 
Factsheet text, and mark 
them as a keyword. The 
keyword is added to the 
Factsheet's Keys window 
and can be used to later 
Find the Factsheet in the 
stack. 


You can also type ۰ 


In addition to selecting 
text to mark as a 
keyword, you can 
automatically mark the 
previous word (from the 
insertion point up to the 
previous space). Simply 
select the command or 
type 38M. Be careful about 
punctuation—it will be 
part of the keyword and 


need to be included inlater 


searches 


Show Automatic 


Lets you display the 
Automatic Keys window 
and begin adding 
keywords there. 
Automatic Keywords can 
be added automatically to 
any subsequent 
Factsheets you create. 
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Note that there are many 
other times when 
Factfinder gives you the 
opportunity to save anew 
or changed Factsheet. For 
example: 


m you can select New 0 
save your current 
Factsheet; then begin a 
new one. 


m you can close the 
Factsheet window. 


= you can close your 
stack, or quit the 
Factfinder program. 


Change Name 


Lets you change the name 
of the Factsheet displayed 
in the active Factsheet 
window. 


After you type anew 
name, that name appears 
both on the Factsheet and 
its Keys window. 
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Factfinder ” 


This is the icon that 
represents the Factfinder 
program. You'll see it 
inside the window that 
displays your disk's 
contents on the desktop. 


Double click this icon to 
start the Factfinder 
program. Then either 
Create a Stack or Open a 
Stack to begin working. 





Examples 


This is the icon that 
represents a stack of 
Factsheets. You ll see one 
for each stack you've 
created— inside the 
window that displays 
your disk’s contents on 
the desktop. 


‘Double click’ on a stack 
icon to automatically start 
the Factfinder program 
AND open that stack. 


Window Buttons and 
Icons 






Browse backward 
Browse forward 


The "Browse Forward’ 
and "Browse Backward 
buttons are special 
buttons on the center 
bottom of the Factsheet 
window. Click on the right 
browse button to display 
the next Factsheet listed 
in the Names Found 
window. Click on the left 
browse button to display 
the previous Factsheet 
listed there. 


Zoom 


Unzoom 


The Zoom button is a 
special button on the 
lower left of the Factsheet 
window. When the 
window's active, click on 
the button to enlarge the 
window to full-screen 
size. {This is also the width 
of a printed page, SO you 
can see how a Factsheet 
will be printed with 
standard 12-point 
characters). 


The button is a toggle; 
when you've zoomed a 
window, the button 
changes to unzoom. Click 
on it again to return to the 
window's previous size. 
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Command Keys 


Factfinder offers you 
several special command 
key combinations that 
you Can press instead of 
pulling down a menu and 
selecting à command, or 
typing a label on the Find 
window. 


In each case, you press 
and hold the special 
command key 3 while you 
press the letter that 
represents the command 
or label you want. Here's a 
summary of what's 


available: 
3% C Copy 
8€ X Cut 


D Delete Selected‏ عو 
F Find Factsheets‏ 38 


M Mark‏ ع3 

gN New 

9 V Paste 

365 Save 

9 A Select All 

3 7 Undo 

Labels for Find window 
3§ O Name: 

W Created:‏ عق 

SE Modified: 





Special Keys and 
Operators 
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Stands for any remaining 
characters on the end of a 
partial Keyword. 


See the section 
“Composing Search 
Instructions” for 
complete details and 
examples of using these 
operators. You'll find it in 
the chapter: Using 
Factfinder. 


to 

any key in the range per 
Factsheet, ending before 
the second key. 


() 

the criteria inside 
parentheses take 
precedence (are 
evaluated together and 
before the rest of the 
instructions). 


found 

all Factsheets found in the 
previous search. Can be 
used to expand or limit a 
further search. 
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Operators 


Factfinder offers several 
"operators’ that you can 
include in your search 
instructions to Find 
Factsheets in the stack. 
They let your search 
instructions be evaluated 
much like a math 
equation. Here's a 
summary of what's 
available now: 


all 
every Factsheet in the 
stack. 


and 
both keys per Factsheet. 


Or 
either key per Factsheet. 








APPENDIXES 


This appendix contains information on the Load and Unioadcommanas in 
the Utility menu. You can use these commands to: 


O Take all or some of the Factsheets in a stack (along with the name, 
keywords, and dates associated with each one), bundle them into a 
text file on the disk; then merge them into another Factfinder stack. 
You can also load this same text file into a document created in any 
application which supports text files, such as MacWrite. 


Follow the steps in the first section of this appendix 'Merging 
Factsheets from Another Stack.” 


O Create a text file in any program which supports them (such as 
MacWrite), format the file so that it contains the order of information 
that Factfinder needs for Factsheets, then load the text file into 
Factfinder as Factsheets in a stack. 


The section "Preparing Text Files for Loading into Factfinder,”’ later in 
this appendix, explains the format you must use. 


The Unload and Load commands let you move copies of Factsheets from 
one stack to another. You can use these commands to merge Factsheets 
from as many stacks as you please into one or more other stacks; your 
only limitation is your available disk space. 


When you select the Unload command to begin the merge operation, 
Factfinder takes all your ""found’’ Factsheets, along with the name, 
keywords, and dates associated with each one, and copies them into 8 
text file on the disk: 


w Make sure that the Factsheets you want to merge are the ones 
listed in the Names Found window. Find allif you want to merge 
the entire stack. 


= Pull down the Utility menu and select Unloadto text. 


= Fill in the dialog box with a name for the text file that Factfinder 
will create to contain the copies of your Factsheets; then click on 
the OK button. (Don't use a stack's name). 


Appendix A: 
Loading/Unloading 
Factsheets and Text 
Files 


Merging Factsheets from 
Another Stack 
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e b Each Factsheet in a stack must have a unique name. As it loads each 
(if Factsheet, Factfinder checks the name against others in the same 
k P stack. fa duplicate name is found, Factfinder lets you either change the 
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name, skip that Factsheet and continue loading, or cancel the 
remainder of the load. Click on your choice. If you choose to change 4 
Factsheet's name, a dialog box displays for you to type the new name; 
then the load continues. 


The Factsheet "My first Factsheet” already exists in 
the stock 


Bupass this Factsheet 


Cancel remainder of load 
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At the end of the loading, your merged Factsheets are appended to the 
end of the list of any Factsheets that were already in the stack. 


Of course, you can take a text file of Unloaded Factsheets and use it to 
create a document in any application which supports text files, such as 
MacWrite. 


un 
o 


If you have the MacWrite program on your desktop (in memory), simply 
“double click'' on the text file icon to open it in the MacWrite program. 
See the next section of this appendix for an explanation of the contents 
and format of the text file. | 
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This appendix explains how you can. 


O install Factfinder and run it from your hard disk or network. 


O copy Factfinder onto another floppy disk as a demonstration copy for 
colleagues or friends. 


You can copy your Factfinder program using any copying software you 
have available, such as moving the Factfinder program icon from one 
open disk to another, on the Macintosh desktop. You can make the copy 
from floppy disk to floppy disk, or even from hard disk to floppy disk. 


The copy you make runs just like a regular Factfinder, except that it limits 
the creation of new Factsheets 0 16. This lets you give a 
"demonstration'' copy to friends or colleagues so that they can read as 
many Factsheets as you aiready have on the disk, perform searches, print 
Factsheets, and so on...but it also lets us protect our investment. 


tf you want to have a full-fledged backup copy of your Factfinder program 
disk (and you should always have one], all you have to do is fill out and 
return your Factfinder Warranty Registration Card. You M receive a free 
backup copy of your Factfinder program disk, as soon as your warranty 1S 
in force. 


*fm. 





Appendix B: Copying 
Factfinder Software 


Copying the Factfinder 
Program on a Floppy Disk 
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APPENDIXES 


Your Factfinder program disk came with three stacks for you to use while 
you are working with the program: the Examples stack which guides you 
through the chapter A Quick Tour of Factfinder and appears throughout 
this manual, the Gallery stack, and the Hints stack. 


This appendix gives you a brief look at the contents of the last two stacks 
and suggests how you may want to use them. You'll also find information 
on the Factfinder™ Help stack. 


The Gallery stack contains sample Factsheets to illustrate some of the 
many ways that people have found uses for Factfinder, as well as formats 
and types of keywords you may want to use in your own stacks. 


The Hints stack is composed of Factsheets that each contain some 
special tip, hint, or advanced technique that may not be covered in this 
manual. You'll also find information about program parameters So you 
can get the most out of your use of Factfinder. 


After you feel comfortable using the program and this manual, look 
through the names in this stack and browse through the Factsheets for 
those extra tips that can make Factfinder really hum for you. 


Your Factfinder disk comes with a special stack called Factfinder™ Help 
which appears as the Help menu at the top of your screen. When you pull 
down the Help menu, you can select any one of six commands that each 
display a labeled screen and a quick look at that item in the Factfinder 
program. 


When you first begin using Factfinder, you may find these screens helpful 
in remembering some program details while you work. Later, you can 
copy the Factfinder™ Help stack onto another disk for safekeeping; then 
delete it from your Factfinder program disk. This will let you free up a 
considerable amount of disk space for your own work. 


Once you have removed the Factfinder™ Help stack from the Factfinder 
program disk, the Help menu will no longer appear with the other menus 
at the top of your screen. ۱ 


Note: The Factfinder™ Help stack is a unique type of stack: used by the 
program to produce screens for the Help menu. You cannot select the 
Factfinder™ Help stack from the desktop to open the Factfinder program 
(as you could with an ordinary stack}. 
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Appendix C: Stacks 
that Came with the 
Factfinder Program 


The Gallery Stack 


The Hints Stack 


The Help Screens Stack 
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all operator, 56, 70 

and operator, 21, 56, 70 
Appendix A, 73-76 

Appendix B, 77-78 

Appendix C, 79 

Automatic keywords, 53-55, 67 
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Backup copy of Factfinder disk, 77 

Boot disk, 8, 27 

Browsing through stacks and using 
browse buttons, 10-11, 30-31, 
36, 69 
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Changing Factsheet names, 39, 67 
Clear 
keys, 52-53, 65 
text, 38, 65 
Clipboard, 38, 47-49, 65 
Close button, 34 
Closing stacks, 33, 64 
Command (86) keys, 69 
Copy, 37-38, 47-49, 65 
Copying 
backup copy of Factfinder disk, 77 
installing on hard disk or network, 
68, 78 
Factsheet text, 37-38, 47-49, 65 
Factfinder to floppy disk, 77 
text, 38, 47-49, 65 
Creating 
Factsheets, 11-12, 36-37, 66-67 
stacks, 28-29, 64 
Cut, 38, 47-49, 65 








Command Keys and Special 
Characters, 69-70 
Command Keys: 

$ A (Select All), 38, 65 
3€ C (Copy), 38, 47-49, 65 
86 D (Delete Selected), 45-46, 66 
3€ ۲ (Find Factsheets), 60, 66 
8£ M (Mark), 50, 67 
EN (New), 11, 36-38, 66 
ع3‎ S (Save), 38-39, 66 
3€ X (Cut), 38, 47-49, 65 
36 Y (Paste), 38, 47-49, 65 
86 Z (Undo), 65 
Labels used in searching: 
88 O (Name:), 56 
86 W (Created:), 56 
38 E (Modified:), 56 
Special Characters used in 
searching: 
? Wildcard Operator, 57, 70 
( ) Precedence Operator, 21, 
56-57,70 
۰ " Quotes, 57 
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Names Found window, 8-10, 18-22, 
30-33, 46-48 

Naming 
Factsheets, 16-17, 38-39, 66-67 
stacks, 28-29, 64 

Network {installing Factfinder), 68, 
78 

New Factsheets (creating), 11-12, 
36-37, 66-67 





O 


Opening stacks, 8-10, 27-30, 64 
Operators (searching) 

all, 56, 0 

and, 21,56, 70 

found, 57, 70 

or, 21, 56, 70 

to, 56, 70 

(),21, 56-57, 70 

? wildcard, 57, 70 
or operator, 21, 56, 70 
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Page Setup (in printing Factsheets), 
40-43, 64 

Parentheses ( ) operator, 21, 56-57, 
70 





Paste, 38, 47-49, 65 
Precedence ( ) operator, 21, 56-57, 
70 
Printing 
compressed characters, 40-43, 
64 
Factsheets, 22-23, 39-45, 4 
keywords, 44 
labels, 40-43 
standard characters, 40-43, 64 
Program (boot) disk, 8, 27 
backup copy 77 
Protecting stacks, 32 


INDEX 


I 

icon, 8, 27-29, 33, 69 

Index (Factfinder), 58-60, 66 
Inserting text, 37, 47-49, 65 

install (hard disk or network), 68, 78 
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Keys 86 (command), 69 
Keys menu, 13-15, 53-54, 67 
Keys window, 8-10, 13-15, 50-55 
Keywords, 13-15, 49-55 
automatic, 53-55, 67 
character length, 50 
dates, 49, 55-59 
deleting, 14-15, 52-53 
marking, 13-15, 50, 67 
printing, 44 
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AA 

Labels (printing), 40-43 

Loading Factsheets, 49, 67-68, 
73-76 

Locking stacks, 32, 65 
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Macintosh desktop, 8, 27 
Mailing labels, 40-43 
Marking keywords, 13-15, 50, 67 
Menus, 64-68 
Edit, 47,65 
Factfinder, 64-68 
Factsheet, 66-67 ۱ 
File, 8-10, 22-24, 27-33, 64-65 
Help, 61, 68, 79 
Keys, 13-15, 53-54, 67 
Stack, 18-21, 66 
Utility, 67-68, 73-75 
Merging stacks, 49, 73-75 
Moving 
text, 38, 47-49, 65 
windows, 34 
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Limited Warranty 


Forethought is committed to 
providing quality products and has 
established the following warranty 
for MACWARE products: 


For a period of 90 days from 
the date of the sublicense, 
Forethought warrants that the 
materials of the software and 
disk and the user's manual 
are not defective and that the 
program is properly recorded 
on the disk. Forethought also 
warrants that the program 
operates substantially as 
described in the user's manual 
and that the user's manual 
contains all information which 
Forethought and its software 
suppliers deem necessary 

for use of the software. 


FORETHOUGHT LIMITS ALL 
IMPLIED WARRANTIES, 
INCLUDING WARRANTIES 

OF MERCHANTABILITY, 
PERFORMANCE, AND FITNESS 
FOR A PARTICULAR PURPOSE 
TO A PERIOD OF 90 DAYS 

FROM THE DATE OF 
SUBLICENSE; FURTHER, 
FORETHOUGHT LIMITS THE 
SUBLICENSEE'S ("THE 
CUSTOMER'S") REMEDIES 

TO RETURN OF THE SOFTWARE 
AND USER'S MANUAL TO THE 
DEALER OR MACWARE FOR 
REPLACEMENT. SOME STATES 
DO NOT ALLOW THE EXCLUSION 
OR LIMITATION OF IMPLIED 
WARRANTIES OR LIABILITY FOR 
INCIDENTAL OR CONSEQUENTIAL 
DAMAGES, SO THE ABOVE 
LIMITATION OR EXCLUSION MAY 
NOT APPLY TO YOU. 


This Limited Warranty is 
implemented solely through the 
MACWARE Product Replacement 
Program. 


Customer Service Support Line 


All MACWARE products are 
fully tested and include a 
comprehensive user's manual. 
However, should you encounter 


.any difficulty in using the 


program, or if you find it not 
operating as described, please 
follow these steps: 


1. Review the instructional 
materials provided in the 
user's manual. Check to 
make sure you have correctly 
configured the system 
and that the program 
supports the operating 
system, peripherals and 
computer configuration. 


2. Consult your dealer. Most 
dealers are familiar with 
Macintosh and MACWARE 
products. Your dealer is your 
best source of convenient 
local service. 


3. Lastly, if you cannot get 
your question answered or 
problem resolved, call 
1 800 MACWARE and ask 
for a Customer Services 
Representative. Lines will be 
operational from 8:30 am to 
5:30 pm (Pacific Time). Please 
have your registration number 
available (it's on the disk 
label), as welt as all information 
relevant to your question. 


MACWARE Upgrade Program 


Forethought is constantly looking 
for ways to enhance MACWARE 
products by incorporating new 
capabilities and features. These 
new versions will be available to 
those who are registered with 
Forethought at special low prices. 
Registered customers will be 
notified of the new version by mail 
when it is released, and given the 
opportunity to purchase the new 
version at special low prices for a 
specified time. 





Customer Service Policy 


Forethought backs every 
MACWARE product with a 
commitment to provide you with 
the type of superior quality 
software, user's manuals and 
after-the-sale support you 
deserve. All MACWARE products 
are supported by customer 
services which are designed to 
assure your successful use of the 
product. Also, it is a Forethought 
goal to provide these services 

in a professional and courteous 
manner. 


To take full advantage of these 
services, you must register with 
Forethought. Please take a few 
moments now to complete the 
Warranty Registration Card 
attached to this document and 
forward it to Forethought as soon 
as possible. Forethought pays the 
postage. As a registered owner, 
you wil! have access to: 


© The Customer Service 
Support Line 

e The MACWARE Upgrade 
Program 

e The MACWARE Product 
Replacement Program 
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FileMaker 


FileMaker is the comprehensive file, form, and report system for all 
your business database needs. 


First, FileMaker is a truly flexible structured database that won't make 
you anticipate all your database needs before you begin. You can 
easily decide what you want to store, and how you want it to look, at 
any time...and you can change your mind as often as you need to. 


Second, FileMaker is a visual database that puts the intuitive strength 
and graphics capabilities of your Macintosh" to practical use. Now 
you can reproduce your existing business forms or design attractive 
and effective new ones. With a full range of calculating and sum- 
marizing features, you can give your reports visual impact and get the 
broadest use of your data. 


FileMaker maximizes the benefits that convinced you to be a Macintosh 
user in the first place. 


MACWARE 


و 
كا 





